Copia local de WordPress Codex?

44

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é tratando de reflejarlo usando wget, pero los resultados fueron irregulares (¡es demasiado grande!).

¿Hay una mejor manera?

artlung
fuente
¿Obtener un iPad con acceso 3G? ;-)
MikeSchinkel

Respuestas:

21

Utilizo una forma mucho más rápida y fácil de crear una copia local del códice sin instalar un servidor local y sin instalar una copia de mediawiki, llamada ScrapBook, que es una extensión de Firefox, que te ayuda a guardar páginas web y administrar la colección. Las características clave son ligereza, velocidad, precisión y soporte multilingüe.

utilizando su función Guardar sitio web (Captura en profundidad) puede configurar los directorios que desea guardar, que en su caso serían Function ReferenceyTemplate Tags

ingrese la descripción de la imagen aquí

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

Bainternet
fuente
Esto es muy bueno ¿Hay alguna manera de alimentarlo con una lista de URL para capturar para ver más tarde? ¿Y hay una manera de decir "ve a actualizar esta lista de URL"?
artlung
Sí, y en cuanto a refrescar, aún no estoy seguro.
Bainternet
Solo lo probé y tiene una función de captura de nuevo.
Bainternet
Esta es una excelente forma ligera de guardar rápidamente un gran grupo de archivos. Tenía la esperanza de ser autónomo, pero he estado probando esto desde que abrí la recompensa y esta es la forma más fácil y rápida de obtener una copia local de los documentos relevantes.
artlung
1
¿Hay alguna forma de buscar las páginas que has guardado?
45

Su 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 alimenta el Codex.

Una vez que haya instalado eso, puede indicarle al Codex que exporte las páginas que desee y puede importar los documentos XML en su instalación local. No está automatizado, pero debería brindarle suficiente información para trabajar para obtener referencias rápidas.

Obtén MediaWiki

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

Si puede ejecutar WordPress localmente, también debería poder ejecutar MediaWiki localmente (necesita tanto PHP como MySQL para configurar las cosas).

Exportar el Codex

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

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

Digamos que solo quieres exportar la Function Referencepágina. Deberías ingresar "Function_Reference" en el cuadro grande para los nombres de página. Coloque un nombre de página por línea para exportar varias páginas a la vez.

Pero como esa página no es muy útil ... exporta la Functionscategoría completa en su lugar. Ingrese "Funciones" en el cuadro de categoría y haga clic en Agregar. El Codex enumerará automáticamente todas las 964 páginas de funciones por usted. Luego, simplemente agregue una línea para "Function_Reference" para que también obtenga el índice.

Códice con páginas de referencia de funciones preseleccionadas

Puede ver una lista de todas las páginas disponibles en http://codex.wordpress.org/Special:AllPages . La lista es bastante extensa, por lo que no la cubriré aquí ... pero agregue cada página que desee exportar y haga clic.

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

Importar el Codex

Ahora navegue de regreso a su instalación local de MediaWiki. Ahora puede importar el documento XML y crear su "clon" local del Codex de WordPress.

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

EAMann
fuente
44
¡Gran respuesta! Empecé a mirar la API de MediaWiki y ni siquiera me di cuenta de que el Codex tenía una exportación.
Chris_O
Algunas páginas ahora se han transferido a developer.wordpress.org, que las excluye de la categoría Funciones. Al exportar, se Functionsperderán páginas (por ejemplo get_permalink, no se incluirán). Calculo que falta aproximadamente el 20%.
Pim Schaaf
9

Puede usar aplicaciones Dash (OS X) o Zeal (Linux, Windows) que tienen un raspado de referencia de función Codex disponible como conjunto de documentación.

Es fácil de instalar y usar, sin embargo, es un poco confuso qué tan actualizados se mantienen los conjuntos.

Rarst
fuente
3
Soy el desarrollador de Dash. Actualizo el documento de WordPress cada vez que sale una nueva versión de WordPress.
bogdansrc
1
¿Soy el único que piensa que Zeal (o Dash) está extremadamente subestimado y esta respuesta debería ser la respuesta aceptada ahora ?
Ejaz
@Ejay la respuesta aceptada es la elegida por OP, ya que funcionó para ellos. :) Es normal que varias respuestas ofrezcan diferentes opiniones sobre la pregunta.
Rarst
Gracias Rarst Recientemente migré de Mac a Linux y Zeal es justo lo que estaba buscando. FWIW bogdansrc, compré Dash varias veces en Mac, y como eres generoso con los docsets, siempre lo promocionaré a los desarrolladores de Mac. ;)
corysimmons
6

Creo que lo mejor sería crear un informe de error y pedirle a la fundación WP que instale esta extensión http://www.mediawiki.org/wiki/Extension:PdfBook. Si no hay nada más, márquelo para uso privado y luego proporcione el PDF generado para los usuarios

Ryan Gibbons
fuente
4

Lo hice por mí mismo usando HTTrack (http://www.httrack.com/). Terminó siendo un puñado de megabytes (no estoy seguro del número exacto ahora, perdí mi copia local debido a una falla del disco duro y no me he molestado en reconstruirla aún), pero funcionó bastante bien.

Keith S.
fuente
:-( Hombre, tiene que haber una mejor manera. Sin embargo, gracias por la respuesta. ¡Espero que haya algo más!
Artlung
¿Hay algo así para Mac?
Mild Fuzz
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.
2

Puedes usar la API MediaWiki . Hay documentación completa sobre cómo duplicar un wiki usando la API y otros métodos.

Chris_O
fuente
¿Es posible almacenar en un conjunto estático de html, o necesito ejecutar Apache / PHP (o los requisitos actuales 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. sciencemedianetwork.org/wiki/…
artlung
Si lo está utilizando para desarrollar WordPress localmente, entonces ya está ejecutando Apache / PHP y cumple con los requisitos para ejecutar MediaWiki localmente.
EAMann
@EAMann en realidad conozco a algunas personas que usan IIS pero entiendo tu punto. Diré nuevamente que las instrucciones vinculadas a la falta de detalles. No hay una "receta" creada para ejecutar la copia de seguridad.
artlung
Ejecutar MediaWiki bajo IIS sería un problema completamente diferente. Pero entiendo tu punto. Incluso en una caja de Windows, simplemente instalaría XAMPP o una solución similar para ejecutar cosas localmente.
EAMann
1

Buena idea,

Hay algunas formas de hacerlo "local".

  • Podrías hacer un truco recursivo en él. Esto lleva mucho tiempo. Como lo mencionaste.
  • Puedes usar un raspador de pantalla: http://scraperwiki.com
  • Podrías escribir un script que solo lo guarde localmente cada vez que te conectes a internet.
  • Podrías ponerte sucio y cada vez que visitas el códice puedes guardarlo en una carpeta.

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

Tal vez escribiré eso ...


Volveré a publicar más tarde esta noche. De hecho, podría haber hecho esto en un momento.

Lo pondré en GitHub.

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

Sterling Hamilton
fuente
1

Sé que este es un hilo viejo pero ha estado reuniendo éxitos, así que agregaré esta respuesta

devdocs.io tiene todas las API para WordPress que necesita, aunque no está estructurado como la versión del Codex, todavía es útil en algunos casos.

NOTA: no se trata solo de documentos de WordPress, sino también de muchos otros idiomas populares

tomexsans
fuente