# Engineer en un terminal

Este sitio responde mediante cuatro protocolos, desde una sola carpeta de archivos en un único servidor. Si vive en un terminal, nunca tiene que abrir un navegador para leerlo.

Los formatos públicos del sitio que se describen a continuación no requieren una cuenta, una clave ni un cliente que tenga que compilar. Los repositorios del código fuente son privados; la sección sobre SSH explica las condiciones de acceso.

## Cada página también está en Markdown

Cada página tiene una versión en Markdown junto a su HTML. Solicite cualquiera de las dos.

```sh
# The twin, by name
curl -sL https://engineer.company/about/index.md

# Or ask the server for it and let it choose
curl -sL -H 'Accept: text/markdown' https://engineer.company/about/
```

Pase el resultado a la herramienta que utilice para visualizar Markdown:

```sh
curl -sL https://engineer.company/portfolio/index.md | glow -
curl -sL https://engineer.company/what-it-costs/index.md | bat -l md
```

Los demás idiomas funcionan igual: `/da/about/index.md`, `/uk/about/index.md`.


Junto al código QR de cada página hay enlaces a JSON, gemtext y un menú Gopher. El JSON de `/es/about/index.json` contiene los metadatos y el contenido de esa página en Markdown; `/es/feed.json` es el canal independiente del portafolio. Solicite `index.json` directamente: `Accept: application/json` no lo selecciona desde la dirección HTML. Ver PDF abre el PDF de la página en una pestaña nueva; Descargar PDF ofrece el mismo archivo para descargar. Estos archivos estáticos se generan antes de publicar el sitio, con el diseño de impresión de la página. Los enlaces usan las funciones nativas del navegador y no añaden JavaScript al navegador.

## Una cápsula Gemini

Gemini es un protocolo pequeño que incorpora la filosofía de este sitio: documentos de texto mediante TLS, sin scripts, sin cookies y sin nada con lo que seguirle. Cada página de este sitio existe también en gemtext.

```text
gemini://engineer.company/
```

Cualquier cliente Gemini puede leerla: Amfora, Lagrange o Bombadillo en un terminal; Castor o Kristall en una ventana. En un Mac con Homebrew:

```sh
brew install amfora && amfora gemini://engineer.company/
```

## Un espacio Gopher

Gopher es un protocolo de menús de 1991 — TCP sencillo, sin cifrado ni scripts —, y allí el sitio es un conjunto de menús, uno por directorio.

```text
gopher://engineer.company/
```

Lynx lo admite de serie, al igual que Bombadillo y gopher-cli. También puede solicitar un selector a mano: todo el protocolo en una línea.

```sh
printf '/contact\r\n' | nc engineer.company 70
```

## Un servicio onion

El mismo sitio mediante Tor, para quien no quiera que su red sepa qué está leyendo:

```text
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/
```

Utiliza `http://` deliberadamente: una dirección onion codifica la clave pública de identidad del servicio. Tor autentica el servicio y cifra la conexión antes de que se intercambie HTTP. Con Tor ejecutándose localmente, `curl` accede de forma directa:

```sh
curl -sL --socks5-hostname 127.0.0.1:9050 \
  http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/index.md
```

## Leer el trabajo como datos

El portafolio se distribuye mediante tres formatos, cada uno con el texto completo de todas las entradas en lugar de un extracto:

```sh
curl -s https://engineer.company/feed.json | jq -r '.items[] | .title'
curl -s https://engineer.company/index.xml     # RSS
curl -s https://engineer.company/atom.xml      # Atom
```

Y el sitio conserva un mapa de sí mismo para cualquier sistema que prefiera leerlo a rastrearlo:

```sh
curl -s https://engineer.company/llms.txt
curl -s https://engineer.company/humans.txt
curl -s https://engineer.company/.well-known/security.txt
```

## El código fuente, mediante SSH

El código fuente del sitio se conserva en repositorios privados de nuestro servidor git. Las personas autorizadas acceden por SSH con una clave SSH aprobada:

```sh
ssh git.engineer.company
```

El comando abre la interfaz del servidor. Los repositorios que puede consultar dependen del acceso concedido a su clave SSH. La página pública git.engineer.company describe el servicio; no publica el contenido de los repositorios.

## Por qué existe todo esto

Un despliegue escribe una carpeta y cuatro vías de acceso la leen, de modo que ninguna puede divergir de las demás y ninguna es una copia del sitio mantenida por separado. Una página que se lee bien en gemtext es una página cuya estructura es real y no solo visual, la misma propiedad que permite leerla bien con un lector de pantalla e imprimirla correctamente en papel. La página de créditos identifica los servicios que hay detrás de cada vía.

Construimos soluciones que se leen bien sin navegador porque suele ser señal de que están bien construidas: pídanos que construyamos una para usted (con sus tuberías y códigos de salida).

=> /es/glossary/#gemtext gemtext
=> /es/glossary/#tor Tor
=> /es/glossary/#onion onion
=> https://git.engineer.company/ git.engineer.company
=> /es/credits/ página de créditos
=> /es/contact/ pídanos que construyamos una para usted

=> https://software.engineer.company/es/cli/ Esta página en la web
