Conteo y análisis

Los comandos page count analizan la estructura de una página de Confluence contando los tipos de nodo ADF (elementos estructurales como párrafos, tablas y encabezados) y los tipos de marca (formato en línea como negrita, cursiva y color de texto) presentes en el documento.

Esto es útil para:

entender la complejidad de una página antes de convertirla
identificar páginas con formato muy cargado o no compatible
auditar contenido para planificación de migración

Contar tipos de nodo


acp2md page count nodes by-id PAGE_ID [flags]

Devuelve cuantas veces aparece cada tipo de nodo ADF en la página.

Ejemplos


# Salida en tabla (por defecto)
acp2md page count nodes by-id 123456
 
# Salida JSON: pasala a jq para filtrar
acp2md page count nodes by-id 123456 --format json
 
# Salida YAML
acp2md page count nodes by-id 123456 --format yaml
 
# Guarda en un archivo
acp2md page count nodes by-id 123456 --format json --output nodes.json
 
# Analiza una versión concreta
acp2md page count nodes by-id 123456 --version 5
 
# Analiza un borrador
acp2md page count nodes by-id 123456 --get-draft
 
# Envia el ID de página por stdin
echo "123456" | acp2md page count nodes by-id

Ejemplo de salida (tabla)


NODE TYPE              COUNT
──────────────────────────────
paragraph              42
text                   198
heading                12
bulletList             8
listItem               31
table                  5
tableRow               24
tableCell              96
codeBlock              3
inlineCard             7

Contar tipos de nodo por título


acp2md page count nodes by-title "PAGE TITLE" [flags]

Usa esta variante cuando la gente conoce el título de la página, pero el ID no esta disponible de inmediato.

Flag adicional

Flag	Short	Predeterminado	Descripcion
`--sort`	`-S`	(ninguno)	Ordena coincidencias: `id`, `-id`, `created-date`, `-created-date`, `modified-date`, `-modified-date`, `title`, `-title`

Contar tipos de nodo por URL


acp2md page count nodes by-url URL [flags]

Alias: url, u

Extrae el ID de página de una URL de Confluence y cuenta tipos de nodo. Formatos de URL compatibles:

https://domain.atlassian.net/wiki/spaces/KEY/pages/123456/Page+Title
https://domain.atlassian.net/wiki/spaces/KEY/pages/123456
https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Ejemplos


# Cuenta nodos desde una URL de Confluence
acp2md page count nodes by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456"
 
# Salida JSON
acp2md page count nodes by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" --format json
 
# Guarda en un archivo
acp2md page count nodes by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" --output nodes.json
 
# Envia la URL por stdin
echo "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" | acp2md page count nodes by-url

Contar tipos de mark


acp2md page count marks by-id PAGE_ID [flags]

Devuelve cuantas veces aparece cada tipo de mark ADF (formato en linea) en la página.

Ejemplos


# Salida en tabla (por defecto)
acp2md page count marks by-id 123456
 
# Salida JSON
acp2md page count marks by-id 123456 --format json
 
# Salida YAML
acp2md page count marks by-id 123456 --format yaml
 
# Guarda en un archivo
acp2md page count marks by-id 123456 --output marks-report.txt
 
# Analiza una versión concreta
acp2md page count marks by-id 123456 --version 5
 
# Envia el ID de página por stdin
echo "123456" | acp2md page count marks by-id

Ejemplo de salida (tabla)


MARK TYPE              COUNT
──────────────────────────────
strong                 34
em                     12
code                   18
textColor              47
link                   23
underline              5

Un valor alto de textColor significa que la página generara muchos elementos <span style="color: ..."> en Markdown, salvo que se use --exclude-marks durante la conversion.

Contar tipos de mark por título


acp2md page count marks by-title "PAGE TITLE" [flags]

Usa esta variante cuando necesites análisis de marks para una página seleccionada por título exacto en lugar de ID o URL.

Contar tipos de mark por URL


acp2md page count marks by-url URL [flags]

Alias: url, u

Extrae el ID de página de una URL de Confluence y cuenta tipos de mark. Formatos de URL compatibles:

https://domain.atlassian.net/wiki/spaces/KEY/pages/123456/Page+Title
https://domain.atlassian.net/wiki/spaces/KEY/pages/123456
https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Ejemplos


# Cuenta marks desde una URL de Confluence
acp2md page count marks by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456"
 
# Salida JSON
acp2md page count marks by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" --format json
 
# Guarda en un archivo
acp2md page count marks by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" --output marks.json
 
# Envia la URL por stdin
echo "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" | acp2md page count marks by-url

Flags (ambos comandos)

Flag	Short	Predeterminado	Descripcion
`--output`	`-o`	(stdout)	Ruta del archivo de salida
`--format`	`-f`	`table`	Formato de salida: `table`, `json`, `yaml`, `csv`, `tsv`
`--get-draft`	`-d`	`false`	Analiza la versión borrador
`--status`	`-s`	`current`	Estado de página: `current`, `archived`, `trashed`, `deleted`, `draft`
`--version`	`-v`	`-1` (ultima)	Analiza un numero de versión concreto
`--include-labels`	`-l`	`false`	Incluye etiquetas de página
`--include-versión`	`-V`	`false`	Incluye información de versión
`--include-versions`	`-L`	`false`	Incluye el historial completo de versiones

Para las variantes by-title, --sort también esta disponible con los mismos valores usados por page get by-title y page convert by-title.

Avanzado: filtra la salida JSON con jq


# Muestra solo los tipos de nodo con mas de 1 aparicion
acp2md page count nodes by-id 123456 --format json \
  | jq '[.nodes[] | select(.count > 1)] | sort_by(-.count)'
 
# Muestra solo los tipos de mark presentes (count > 0)
acp2md page count marks by-id 123456 --format json \
  | jq '.marks // [] | map(select(.count > 0))'