Локальная копия WordPress Codex?

44

Иногда я хочу разрабатывать темы WordPress, когда у меня нет подключения к интернету. Мне нужно, чтобы ссылка на функцию и теги шаблона были продуктивными.

Я искал загружаемую или кодексную копию Кодекса, но не смог ее найти. В итоге я попытался отразить это, используя результаты wget, но результаты были пятнистыми (это слишком много!).

Есть ли способ лучше?

artlung
источник
Получить iPad с доступом 3G? ;-)
MikeSchinkel

Ответы:

21

Я использую гораздо быстрее и проще создать локальную копию Codex без установки локального сервера и без установки копии MediaWiki, его называют ScrapBook , который является расширение Firefox, который поможет вам сохранять веб - страницы и управлять коллекцией. Ключевые особенности: легкость, скорость, точность и многоязычная поддержка.

используя его Сохранение веба - сайт (Углубленный Capture) Функцию Вы можете установить каталоги , которые вы хотите сохранить, что в вашем случае будет Function ReferenceиTemplate Tags

введите описание изображения здесь

Вы также можете организовывать свои коллекции так же, как закладки, редактировать сохраненные файлы и выделять ключевые части страниц, и самое интересное - встроенный полнотекстовый поиск.

Bainternet
источник
Это довольно здорово. Есть ли способ предоставить ему список URL-адресов для захвата для последующего просмотра? И есть ли способ сказать "иди обновите этот список URL-адресов"?
artlung
Да и что касается освежения, я еще не уверен.
Bainternet
Только что попробовал, и у него есть функция захвата снова.
Bainternet
Это отличный легкий способ быстро сохранить большую группу файлов. Я надеялся на самодостаточность, но я проверял это с тех пор, как открыл награду, и это самый простой и быстрый способ получить локальную копию соответствующих документов.
artlung
1
Есть ли способ поиска страниц, которые вы сохранили?
45

Лучше всего установить локальную копию MediaWiki. Это то же самое программное обеспечение, которое запускает Википедию, но это также приложение, которое обеспечивает работу Кодекса.

После того, как вы это установили, вы можете указать Кодексу экспортировать нужные вам страницы и импортировать документы XML в вашу локальную установку. Это не автоматизировано, но должно дать вам достаточно информации для быстрой работы.

Получить MediaWiki

Вся документация для загрузки, установки и настройки MediaWiki доступна онлайн .

Если вы можете запускать WordPress локально, вы также должны иметь возможность запускать и MediaWiki локально (для настройки необходимы PHP и MySQL).

Экспортируйте Кодекс

Составьте список страниц, которые вы хотите экспортировать. Я был бы рад, если бы существовал автоматизированный инструмент для экспорта всего , но в отсутствие этого давайте придерживаться ручного процесса.

Перейдите по адресу http://codex.wordpress.org/Special:Export . Эта страница позволяет пометить, какие страницы и категории вы хотите экспортировать.

Допустим, вы просто хотите экспортировать Function Referenceстраницу. Вы должны ввести «Function_Reference» в большое поле для имен страниц. Поместите одно имя страницы в строку, чтобы экспортировать несколько страниц одновременно.

Но поскольку эта одна страница не очень полезна ... Functionsвместо этого экспортируйте всю категорию. Введите «Функции» в поле категории и нажмите « Добавить». Кодекс автоматически выведет список всех 964 функциональных страниц для вас. Затем просто добавьте строку для «Function_Reference», чтобы вы также получили индекс.

Кодекс с предварительно выбранными справочными страницами функций

Вы можете увидеть список всех доступных страниц на http://codex.wordpress.org/Special:AllPages . Список довольно обширен, поэтому я не буду его охватывать здесь ... но добавлю каждую страницу, которую вы хотите экспортировать, и щелкните по ссылке.

После того, как вы нажмете «Экспорт», Кодекс сгенерирует (довольно большой) XML-файл, содержащий все содержимое.

Импортируйте Кодекс

Теперь вернитесь к вашей локальной установке MediaWiki. Теперь вы можете импортировать документ XML и создать свой локальный «клон» Кодекса WordPress.

Подробные инструкции по импорту доступны на сайте MediaWiki .

EAMann
источник
4
Отличный ответ! Я только начал смотреть на MediaWiki API и даже не осознавал, что у Кодекса есть экспорт.
Chris_O
Некоторые страницы теперь перенесены на developer.wordpress.org, что исключает их из категории «Функции». Экспорт Functionsприведет к отсутствию страниц (например get_permalink, не будет включен). Я предполагаю, что примерно 20% не хватает.
Пим Шааф
9

Вы можете использовать приложения Dash (OS X) или Zeal (Linux, Windows), которые имеют справочную информацию о функциях Кодекса, доступную как набор документации.

Он прост в установке и использовании, однако немного неясен, насколько современными являются наборы.

Rarst
источник
3
Я разработчик Dash. Я обновляю набор документов WordPress каждый раз, когда выходит новая версия WordPress.
bogdansrc
1
я единственный, кто думает, что Рвение (или Дэш) чрезвычайно недооценено, и этот ответ должен быть принятым ответом сейчас ?
Ejaz
@ Ejay, принятый ответ - тот, который выбрал OP, так как он работал на них. :) Это нормально, когда несколько ответов предлагают разные взгляды на вопрос.
Первое
Спасибо, Рарст. Недавно я перешел с Mac на Linux, и Zeal - это то, что я искал. FWIW bogdansrc, я несколько раз покупал Dash на Mac, и, поскольку вы щедры на docsets, я всегда буду рекламировать его для разработчиков Mac. ;)
corysimmons
6

Я думаю, что лучше всего было бы создать отчет об ошибке и попросить фонд WP установить это расширение. Http://www.mediawiki.org/wiki/Extension:PdfBook. Если ничего больше, отметьте его для личного пользования, а затем предоставьте сгенерированный PDF. для пользователей.

Райан Гиббонс
источник
4

Я сделал это для себя, используя HTTrack (http://www.httrack.com/). В итоге получилось несколько мегабайт (сейчас я точно не знаю точное число, я потерял локальную копию из-за сбоя жесткого диска и пока не удосужился восстановить ее), но он работал довольно хорошо.

Кит С.
источник
:-( Человек, должен быть лучший способ. Спасибо за ответ, хотя. Надеюсь, есть что-то еще!
artlung
Есть ли что-нибудь подобное для Mac?
Мягкий пух
Есть приложение под названием BlueCrab, которое делает что-то похожее, но я не могу говорить о его использовании, так как никогда не использовал его.
Кит С.
2

Вы можете использовать MediaWiki API . Существует полная документация о том, как отражать вики с помощью API и других методов.

Chris_O
источник
Можно ли сохранить статический набор html или мне нужно запустить Apache / PHP (или какие-либо текущие требования MediaWiki) на целевом устройстве? В деталях реализации отсутствует простой набор инструкций, вместо этого они указывают на другие решения на разных этапах полноты. sciencemedianetwork.org/wiki/…
artlung
Если вы используете его для локальной разработки WordPress, то вы уже используете Apache / PHP и соответствует требованиям для локального запуска MediaWiki.
EAMann
@ На самом деле я знаю, что некоторые люди используют IIS, но я понимаю вашу точку зрения. Скажу еще раз, что инструкции связаны с отсутствием деталей. Не существует «рецепта», созданного для фактического запуска резервного копирования.
artlung
Запуск MediaWiki под IIS будет отдельной проблемой. Но я понимаю вашу точку зрения. Даже на Windows-сервере я бы просто установил XAMPP или подобное решение для локального запуска.
EAMann
1

Классная идея,

Есть несколько способов сделать его "локальным".

  • Вы можете сделать рекурсивный Wget на нем. Это занимает много времени. Как вы упомянули.
  • Вы можете использовать скребок для экрана: http://scraperwiki.com
  • Вы можете написать скрипт, который будет сохранять его локально каждый раз, когда вы подключаетесь к Интернету.
  • Вы можете просто запачкаться, и каждый раз, посещая кодекс, вы можете просто сохранить его в папке.

Короче говоря, сейчас нет хранилища для этого. Хотя делать одно было бы круто.

Может быть, я напишу это ...


Я вернусь позже сегодня вечером. Я мог бы на самом деле сделать это немного.

Я положу это на GitHub.

Обновление: ответ MediaWiki, как это должно быть сделано на самом деле.

Стерлинг гамильтон
источник
1

Я знаю, что это старая тема, но она собирает хиты, поэтому я добавлю этот ответ

У devdocs.io есть все API для WordPress, которые вам нужны, хотя он не структурирован, как версия Кодекса, но в некоторых случаях он по-прежнему полезен.

ПРИМЕЧАНИЕ. Это не только документы WordPress, но и многие другие популярные языки.

tomexsans
источник