¿Copia local del WordPress Codex?

12 ago 2010, 17:39:20
Vistas: 24.6K
Votos: 49

A veces quiero desarrollar temas de WordPress cuando no tengo conexión a internet. Necesito la Referencia de Funciones y las Etiquetas de Plantilla para ser productivo.

Busqué una copia descargable o SVN del Codex pero no pude encontrar una. Terminé intentando hacer un espejo usando wget, pero los resultados fueron irregulares (¡es demasiado grande!).

¿Hay una mejor manera?

1
Comentarios

¿Conseguir un iPad con acceso 3G? ;-)

MikeSchinkel MikeSchinkel
12 ago 2010 20:05:09
Todas las respuestas a la pregunta 8
2
46

Tu mejor opción es configurar una copia local de MediaWiki. Este es el mismo software que ejecuta Wikipedia, pero también es la aplicación que impulsa el Codex.

Una vez que lo hayas instalado, puedes indicarle al Codex que exporte las páginas que deseas y puedes importar los documentos XML a tu instalación local. No es un proceso automatizado, pero debería darte suficiente información para trabajar como referencia rápida.

Obtener MediaWiki

Toda la documentación para descargar, instalar y configurar MediaWiki está disponible en línea.

Si puedes ejecutar WordPress localmente, deberías poder ejecutar MediaWiki localmente también (necesitas tanto PHP como MySQL para configurarlo).

Exportar el Codex

Haz una lista de las páginas que deseas exportar. Me encantaría que existiera una herramienta automatizada para exportar todo, pero en ausencia de eso, sigamos con el proceso manual.

Navega a http://codex.wordpress.org/Special:Export. Esta página te permite marcar qué páginas y categorías deseas exportar.

Digamos que solo quieres exportar la página Function Reference. Introducirías "Function_Reference" en el cuadro grande para nombres de página. Coloca un nombre de página por línea para exportar múltiples páginas a la vez.

Pero como esa sola página no es muy útil... exporta toda la categoría Functions en su lugar. Introduce "Functions" en el cuadro de categoría y haz clic en agregar. El Codex listará automáticamente las 964 páginas de funciones. Luego solo agrega una línea para "Function_Reference" para obtener también el índice.

Codex con páginas de Function Reference preseleccionadas

Puedes ver una lista de todas las páginas disponibles en http://codex.wordpress.org/Special:AllPages. La lista es bastante extensa, así que no la cubriré aquí... pero agrega cada página que quieras exportar y continúa.

Una vez que hagas clic en "Exportar", el Codex generará un archivo XML (bastante grande) que contiene todo el contenido.

Importar el Codex

Ahora navega de vuelta a tu instalación local de MediaWiki. Ahora puedes importar el documento XML y crear tu "clon" local del WordPress Codex.

Las instrucciones detalladas de importación están disponibles en el sitio web de MediaWiki.

10 mar 2012 02:08:51
Comentarios

¡Excelente respuesta! Acabo de empezar a mirar la API de MediaWiki y ni siquiera me había dado cuenta de que el Codex tenía una opción de exportación.

Chris_O Chris_O
10 mar 2012 02:17:38

Algunas páginas ahora se han transferido a developer.wordpress.org, lo que las excluye de la categoría Funciones. Exportar las Functions dará como resultado páginas faltantes (por ejemplo, get_permalink no se incluirá). Calculo que falta aproximadamente un 20%.

Pim Schaaf Pim Schaaf
8 nov 2016 16:04:39
5
22

Utilizo una forma mucho más rápida y sencilla de crear una copia local del codex sin instalar un servidor local y sin instalar una copia de MediaWiki, se llama ScrapBook que es una extensión de Firefox, que te ayuda a guardar páginas web y administrar la colección. Sus características principales son la ligereza, velocidad, precisión y soporte multilingüe.

Usando su función de Guardar Sitio Web (Captura en Profundidad) puedes configurar los directorios que deseas guardar, que en tu caso serían Function Reference y Template Tags

Captura de pantalla de ScrapBook

También puedes organizar tus colecciones como marcadores, editar archivos guardados y resaltar partes clave de las páginas, y lo mejor de todo es su búsqueda de texto completo integrada.

14 mar 2012 00:26:17
Comentarios

Esto es bastante genial. ¿Hay alguna forma de proporcionarle una lista de URLs para capturar y ver más tarde? ¿Y hay alguna forma de decir "actualiza esta lista de URLs"?

artlung artlung
14 mar 2012 00:57:12

Sí, y en cuanto a la actualización, todavía no estoy seguro.

Bainternet Bainternet
14 mar 2012 01:39:59

Acabo de probarlo y tiene una función para capturar nuevamente.

Bainternet Bainternet
14 mar 2012 01:46:09

Esta es una excelente manera liviana de guardar rápidamente un gran grupo de archivos. Esperaba que fuera autónomo, pero he estado probando esto desde que abrí la recompensa y esta es la forma más rápida y sencilla de obtener una copia local de los documentos relevantes.

artlung artlung
16 mar 2012 02:21:15

¿Hay alguna manera de buscar en las páginas que has guardado?

User User
1 ago 2014 03:16:59
4
10

Puedes usar las aplicaciones Dash (OS X) o Zeal (Linux, Windows) que tienen disponible la referencia de funciones de Codex como conjunto de documentación.

Es fácil de instalar y usar, aunque no está muy claro qué tan actualizados se mantienen los conjuntos.

20 nov 2013 15:03:34
Comentarios

Soy el desarrollador de Dash. Actualizo el conjunto de documentos de WordPress cada vez que sale una nueva versión de WordPress.

bogdansrc bogdansrc
14 may 2014 00:34:37

¿Soy el único que piensa que Zeal (o Dash) está extremadamente infravalorado y que esta respuesta debería ser la respuesta aceptada ahora?

Ejaz Ejaz
19 ago 2015 14:33:00

@Ejay la respuesta aceptada es la que el OP eligió, según lo que funcionó para ellos. :) Es normal tener múltiples respuestas que ofrezcan diferentes enfoques sobre la pregunta.

Rarst Rarst
19 ago 2015 14:51:51

Gracias Rarst. Recientemente migré de Mac a Linux y Zeal es justo lo que estaba buscando. Por si sirve de algo bogdansrc, compré Dash varias veces en Mac, y debido a que eres generoso con los docsets siempre lo recomendaré a los desarrolladores de Mac. ;)

corysimmons corysimmons
13 ene 2017 03:16:23
0

Creo que lo mejor sería crear un informe de error y pedir a la fundación WP que instale esta extensión http://www.mediawiki.org/wiki/Extension:PdfBook. Si no es posible, marcarla para uso privado y luego proporcionar el PDF generado a los usuarios.

12 ago 2010 22:37:44
3

Hice esto para mí usando HTTrack (http://www.httrack.com/). Terminó ocupando unos cuantos megabytes (no recuerdo el número exacto ahora, perdí mi copia local por un fallo en el disco duro y no me he molestado en reconstruirla todavía), pero funcionó bastante bien.

12 ago 2010 18:06:29
Comentarios

:-/ Hombre, tiene que haber una mejor manera. Gracias por la respuesta de todos modos. ¡Espero que haya otra solución!

artlung artlung
12 ago 2010 18:16:53

¿hay algo así para mac?

Mild Fuzz Mild Fuzz
11 oct 2010 11:35:55

Hay una aplicación llamada BlueCrab que hace algo similar, pero no puedo hablar de su uso ya que nunca la he usado.

Keith S. Keith S.
12 oct 2010 21:33:28
4

Puedes utilizar la API de MediaWiki. Existe una documentación completa sobre cómo espejar un wiki usando la API y otros métodos.

10 mar 2012 02:15:05
Comentarios

¿Es posible almacenar en un conjunto estático de HTML, o necesito ejecutar Apache/PHP (o cualquier requisito actual de MediaWiki) en el dispositivo de destino? Los detalles de implementación carecen de un conjunto simple de instrucciones, en su lugar apuntan a otras soluciones en varias etapas de completitud. http://www.sciencemedianetwork.org/wiki/Mediawiki_mirror#Implementation_details

artlung artlung
10 mar 2012 02:25:51

Si lo estás usando para desarrollar WordPress localmente, entonces ya estás ejecutando Apache/PHP y cumples con los requisitos para ejecutar MediaWiki localmente.

EAMann EAMann
10 mar 2012 17:57:06

@EAMann en realidad conozco algunas personas que usan IIS pero entiendo tu punto. Diré nuevamente que las instrucciones enlazadas carecen de detalle. No hay una "receta" creada para ejecutar realmente la copia de seguridad.

artlung artlung
14 mar 2012 02:15:56

Ejecutar MediaWiki bajo IIS sería un tema completamente aparte. Pero entiendo tu punto. Incluso en una máquina con Windows, simplemente instalaría XAMPP o una solución similar para ejecutarlo localmente.

EAMann EAMann
14 mar 2012 03:13:51
0

Sé que este es un hilo antiguo pero ha estado recibiendo visitas, así que agregaré esta respuesta.

devdocs.io tiene todas las API's de WordPress que necesitas, aunque no está estructurado como la versión del Codex, sigue siendo útil en algunos casos.

NOTA: No son solo documentaciones de WordPress, sino también de muchos otros lenguajes populares.

1 oct 2019 09:53:50
0

Buena idea,

Hay varias formas de hacerlo "local".

  • Podrías hacer un wget recursivo. Esto toma mucho tiempo. Como ya mencionaste.
  • Podrías usar un raspador de pantalla: http://scraperwiki.com
  • Podrías escribir un script que simplemente lo guarde localmente cada vez que te conectes a internet.
  • Podrías ensuciarte las manos y cada vez que visites el codex, simplemente guardarlo en una carpeta.

En resumen, no hay un repositorio para esto en este momento. Aunque sería genial crear uno.

Tal vez lo escriba...


Publicaré más tarde esta noche. De hecho, podría tener esto terminado en un rato.

Lo subiré a GitHub.

Actualización: La respuesta de MediaWiki es cómo realmente debería hacerse esto.

10 mar 2012 01:32:06