Listar páginas


acs2md space pages by-id SPACE_ID [flags]

Lista todas las páginas dentro de un espacio de Confluence. Usa by-id cuando ya tengas el ID numerico del espacio, o by-key cuando quieras que acs2md resuelva primero la clave del espacio de Confluence.

Este es el comando clave de pre-flight para verificar el alcance antes de iniciar una conversion masiva, una sincronización de continuidad o una revision de gobernanza.

Subcomandos

acs2md space pages by-id SPACE_ID [flags]
acs2md space pages by-key SPACE_KEY [flags]

by-key resuelve la clave del espacio a su ID numerico y despues lista las páginas.

Ejemplos


# Lista todas las páginas de un espacio por ID numerico
acs2md space pages by-id 123456
 
# Lista todas las páginas de un espacio por clave
acs2md space pages by-key DOCS
 
# Filtra solo páginas publicadas actualmente
acs2md space pages by-id 123456 --status current
 
# Ordena por modificacion mas reciente
acs2md space pages by-key DOCS --sort -modified-date
 
# Muestra el árbol de páginas como jerarquia indentada
acs2md space pages by-id 123456 --tree
 
# Salida JSON, útil para encadenar a jq o scripts
acs2md space pages by-id 123456 --format json
 
# Guarda la salida en un archivo
acs2md space pages by-key DOCS --output pages.json --format json
 
# Combina filtros
acs2md space pages by-id 123456 --status current --sort -modified-date --limit 50

Flags para ambos subcomandos

Flag	Short	Predeterminado	Descripcion
`--limit`	`-l`	`0`	Total de páginas a devolver (`0` = todas, con auto-paginacion)
`--status`	`-s`	`current`	Filtra por estado de página: `all`, `current`, `archived`, `trashed`, `deleted`, `draft`
`--sort`	`-S`	(ninguno)	Orden: `id`, `-id`, `created-date`, `-created-date`, `modified-date`, `-modified-date`, `title`, `-title`
`--tree`	`-t`	`false`	Muestra páginas como árbol jerarquico indentado. Ignora `--limit` y no puede combinarse con `--format json`.
`--format`	`-f`	`table`	Formato de salida: `table`, `json`, `yaml`, `csv`, `tsv`
`--output`	`-o`	(stdout)	Ruta del archivo de salida

Ejemplo de salida (tabla)


ID          TITLE                        STATUS     MODIFIED
────────────────────────────────────────────────────────────────────
123456      Getting Started              current    2024-03-10
789012      API Reference                current    2024-03-08
345678      Release Notes                current    2024-02-28
901234      Migration Guide              archived   2023-11-15

Ejemplo de salida (JSON)


{
  "_links": {
    "self": "",
    "next": ""
  },
  "results": [
    {
      "createdAt": "2024-01-15T09:00:00.000Z",
      "body": {
        "storage": null,
        "atlas_doc_format": null,
        "view": null
      },
      "id": "100101",
      "status": "current",
      "title": "Team Documentation",
      "spaceId": "100001",
      "parentId": "",
      "parentType": "",
      "authorId": "<redacted>",
      "ownerId": "<redacted>",
      "lastOwnerId": "",
      "subtype": "",
      "version": {
        "createdAt": "2024-01-15T09:00:00.000Z",
        "message": "",
        "authorId": "<redacted>",
        "number": 3,
        "minorEdit": false
      },
      "position": 0
    }
  ],
  "meta": {
    "cursor": "",
    "hasMore": false
  }
}

space pages usa --format json en v1.0.0. El flag legado --json ya no es válido.

No existe un flag --cursor en la CLI actual. La paginacion la gestiona el propio comando hasta alcanzar --limit o agotar el resultado.

Ejemplo de salida (árbol)


Space TEAMDOCS (Team Documentation) — 6 pages

Team Documentation (100101)
├── Architecture decisions (100111)
├── Change log (100112)
├── Meeting notes (100113)
├── Product requirements (100114)
└── Retrospectives (100115)

Ese ejemplo se basa en una ejecución real con --tree contra un espacio pequeno y activo, con los títulos de página y los IDs anonimizados.

Uso junto con comandos de página

Combina acs2md space pages con acs2md page ... o acp2md cuando quieras hacer trabajo dirigido despues de listar un espacio:


# Obtiene los IDs de todas las páginas actuales de un espacio y luego recupera cada página en formato nativo
acs2md space pages by-id 123456 --format json \
  | jq -r '.results[] | select(.status == "current") | .id' \
  | while read id; do
      acs2md page get by-id "$id" -f atlas_doc_format > "pages/$id.json"
    done

Usa --tree cuando personas necesiten validar el alcance. Usa --format json cuando máquinas necesiten procesar el resultado.