Copie locale de WordPress Codex?

44

Parfois, je souhaite développer des thèmes WordPress sans connexion Internet. J'ai besoin de la référence de fonction et des balises de modèle pour être productif.

J'ai cherché une copie téléchargeable ou une copie SVN du Codex, mais je n'ai pas pu en trouver. J'ai fini par essayer de l'inverser en utilisant wget, mais les résultats étaient inégaux (c'est trop énorme!).

Y a-t-il un meilleur moyen?

artlung
la source
Obtenir un iPad avec un accès 3G? ;-)
MikeSchinkel

Réponses:

21

I Utilisez un moyen beaucoup plus rapide et plus simple de créer une copie locale du codex sans installer de serveur local ni de copie de mediawiki, appelé ScrapBook, une extension de Firefox, qui vous aide à enregistrer des pages Web et à gérer la collection. Les principales caractéristiques sont la légèreté, la rapidité, la précision et la prise en charge multilingue.

utiliser le site Web ÉCONOMISONS (capture en profondeur) la fonction que vous pouvez définir les répertoires que vous souhaitez enregistrer, ce qui dans votre cas serait Function ReferenceetTemplate Tags

entrez la description de l'image ici

vous pouvez également organiser vos collections de la même manière que des signets, modifier des fichiers enregistrés et mettre en évidence des parties clés de pages. La meilleure chose à ce sujet est la recherche intégrée en texte intégral.

Bainternet
la source
C'est génial. Est-il possible de lui donner une liste d'URL à capturer pour une visualisation ultérieure? Et est-il possible de dire "va actualiser cette liste d'URL"?
artlung
Oui et pour rafraîchir je ne suis pas encore sûr.
Bainternet
Juste essayé et il a une fonctionnalité de capture à nouveau.
Bainternet
C'est un excellent moyen léger de sauvegarder rapidement un grand groupe de fichiers. J'espérais être autonome, mais je le teste depuis que j'ai ouvert la prime et c'est le moyen le plus rapide et le plus simple d'obtenir une copie locale de la documentation pertinente.
artlung
1
Est-il possible de rechercher les pages que vous avez enregistrées?
45

Votre meilleur pari est de créer une copie locale de MediaWiki. C'est le même logiciel qui exécute Wikipedia, mais c'est également l'application qui alimente le Codex.

Une fois l’installation terminée, vous pouvez demander au Codex d’exporter les pages souhaitées et vous pouvez importer les documents XML dans votre installation locale. Ce n'est pas automatisé, mais il devrait vous donner suffisamment d'informations pour que vous puissiez vous y reporter rapidement.

Obtenir MediaWiki

Toute la documentation relative au téléchargement, à l'installation et à la configuration de MediaWiki est disponible en ligne .

Si vous pouvez exécuter WordPress localement, vous devriez également pouvoir utiliser MediaWiki localement (vous avez besoin de PHP et de MySQL pour tout configurer).

Exporter le Codex

Faites une liste des pages que vous souhaitez exporter. J'adorerais s'il y avait un outil automatisé pour tout exporter , mais en l'absence de cela, restons avec le processus manuel.

Accédez à http://codex.wordpress.org/Special:Export . Cette page vous permet de marquer les pages et les catégories que vous souhaitez exporter.

Disons que vous voulez juste exporter la Function Referencepage. Vous devez entrer "Function_Reference" dans la grande case pour les noms de page. Placez un nom de page par ligne pour exporter plusieurs pages à la fois.

Mais comme cette page n’est pas très utile, exportez toute la Functionscatégorie. Entrez "Fonctions" dans la zone de catégorie et cliquez sur Ajouter. Le Codex listera automatiquement toutes les 964 pages de fonctions pour vous. Ensuite, ajoutez simplement une ligne pour "Function_Reference" afin que vous obteniez également l'index.

Pages Codex avec référence de fonction présélectionnées

Vous pouvez voir une liste de toutes les pages disponibles à l' adresse http://codex.wordpress.org/Special:AllPages . La liste est assez longue, je ne la couvrirai donc pas ici ... mais ajoutez chaque page que vous voulez exporter et cliquer dessus.

Une fois que vous avez cliqué sur "Exporter", le Codex générera un fichier XML (plutôt volumineux) contenant tout le contenu.

Importer le Codex

Revenez maintenant à votre installation MediaWiki locale. Vous pouvez maintenant importer le document XML et créer votre "clone" local du Codex WordPress.

Des instructions d'importation détaillées sont disponibles sur le site Web de MediaWiki .

EAMann
la source
4
Très bonne réponse! J'ai juste commencé à regarder l'API MediaWiki et je ne savais même pas que le Codex avait une exportation.
Chris_O
Certaines pages ont maintenant été transférées vers developer.wordpress.org, ce qui les exclut de la catégorie Fonctions. L'exportation du fichier Functionsentraînera des pages manquantes (par exemple get_permalink, ne seront pas incluses). Je pense qu'environ 20% sont manquants.
Pim Schaaf
9

Vous pouvez utiliser des applications Dash (OS X) ou Zeal (Linux, Windows) contenant une référence à la fonction Codex disponible en tant que documentation.

Il est facile à installer et à utiliser, mais un peu flou quant à la mise à jour des ensembles.

Rarst
la source
3
Je suis le développeur de Dash. Je mets à jour le document WordPress à chaque nouvelle version de WordPress.
Bogdansrc
1
Suis-je le seul à penser que Zeal (ou Dash) est extrêmement sous-estimé et que cette réponse devrait être la réponse acceptée maintenant ?
Ejaz
@Ejay, la réponse acceptée est celle choisie par OP, comme ce qui a fonctionné pour eux. :) Il est normal que plusieurs réponses proposent différentes réponses à la question.
Rarst
Merci Rarst. J'ai récemment migré de Mac à Linux et Zeal est exactement ce que je cherchais. FWIW bogdansrc, j’ai acheté Dash à quelques reprises sur Mac, et comme vous êtes généreux avec les docsets, je vais toujours en faire la promotion auprès des développeurs Mac. ;)
corysimmons le
6

Je pense que la meilleure chose à faire serait de créer un rapport de bogue et de demander à la fondation WP d’installer cette extension http://www.mediawiki.org/wiki/Extension:PdfBook. Si rien d’autre, marquez-le pour un usage privé et transmettez ensuite le PDF généré. pour les utilisateurs.

Ryan Gibbons
la source
4

Je l'ai fait moi-même en utilisant HTTrack (http://www.httrack.com/). Cela a fini par devenir une poignée de mégaoctets (je ne suis pas sûr du nombre exact à présent, j'ai perdu ma copie locale en raison d'une défaillance du disque dur et je n'ai pas encore pris la peine de le reconstruire), mais cela a plutôt bien fonctionné.

Keith S.
la source
:-( Homme, il doit y avoir un meilleur moyen. Merci pour la réponse cependant. J'espère qu'il y a autre chose!
artlung
y at-il quelque chose comme ça pour mac?
Doux Fuzz
Il existe une application appelée BlueCrab qui fait quelque chose de similaire, mais je ne peux pas parler de son utilisation, car je ne l'ai jamais utilisée.
Keith S.
2

Vous pouvez utiliser l' API MediaWiki . Il existe une documentation complète sur la mise en miroir d'un wiki à l'aide de l'API et d'autres méthodes.

Chris_O
la source
Est-il possible de stocker dans un ensemble statique de HTML, ou dois-je utiliser Apache / PHP (ou toute autre exigence actuelle de MediaWiki) sur le périphérique cible? Les détails de la mise en œuvre manquent d'un ensemble d'instructions simples, ils indiquent plutôt d'autres solutions à différentes étapes de complétude. sciencemedianetwork.org/wiki/…
artlung
Si vous l'utilisez pour développer WordPress localement, vous utilisez déjà Apache / PHP et vous répondez à la configuration requise pour exécuter MediaWiki localement.
EAMann
@EAMann En fait, je connais quelques personnes qui utilisent IIS, mais je comprends ce que vous dites. Je répète que les instructions liées au manque de détails. Aucune "recette" n'a été créée pour exécuter la sauvegarde.
artlung
Exécuter MediaWiki sous IIS serait une question à part entière. Mais je vois ton point. Même sur une machine Windows, je voudrais simplement installer XAMPP ou une solution similaire pour exécuter des tâches localement.
EAMann
1

Bonne idée,

Il y a plusieurs façons de le rendre "local".

  • Vous pouvez faire un wget récursif dessus. Cela prend beaucoup de temps. Comme vous l'avez mentionné.
  • Vous pouvez utiliser un grattoir d'écran: http://scraperwiki.com
  • Vous pouvez écrire un script qui le sauvegarde localement à chaque fois que vous vous connectez à Internet.
  • Vous pourriez vous salir et chaque fois que vous visiterez le codex, vous pourrez simplement l'enregistrer dans un dossier.

En bref, il n'y a pas de référentiel pour cela pour le moment. Même si en faire un serait cool.

Peut-être que j'écrirai ça ...


Je posterai plus tard ce soir. Je pourrais effectivement avoir cela fait dans un peu.

Je vais le mettre sur GitHub.

Mise à jour: La réponse de MediaWiki est la suivante: comment procéder?

Sterling Hamilton
la source
1

Je sais que c’est un vieux fil conducteur, mais c’est sa recueil de succès, donc je vais ajouter cette réponse.

devdocs.io a toutes les API pour WordPress dont vous avez besoin, même si ce n'est pas structuré comme la version Codex, il est toujours utile dans certains cas.

REMARQUE: il ne s'agit pas uniquement de la documentation WordPress, mais de nombreux autres langages populaires

tomexsans
la source