# 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](/es/glossary/#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](/es/glossary/#tor), para quien no quiera que su
red sepa qué está leyendo:

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

Utiliza `http://` deliberadamente: una dirección [onion](/es/glossary/#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](https://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](/es/credits/) 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](/es/contact/) *(con sus tuberías y códigos de salida)*.

<https://engineer.company/es/cli/>
