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

12 авг. 2010 г., 17:39:20
Просмотры: 24.6K
Голосов: 49

Иногда мне нужно разрабатывать темы WordPress без подключения к интернету. Для продуктивной работы мне необходимы Справочник функций и Шаблонные теги.

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

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

1
Комментарии

Купить iPad с 3G доступом? ;-)

MikeSchinkel MikeSchinkel
12 авг. 2010 г. 20:05:09
Все ответы на вопрос 8
2
46

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

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

Установка MediaWiki

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

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

Экспорт Codex

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

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

Допустим, вам нужна только страница Function Reference. Введите "Function_Reference" в большое поле для названий страниц. Для экспорта нескольких страниц указывайте по одному названию на строку.

Но одна страница не очень полезна... Лучше экспортировать всю категорию Functions. Введите "Functions" в поле категории и нажмите добавить. Codex автоматически перечислит все 964 страницы функций. Затем добавьте строку "Function_Reference", чтобы получить и индекс.

Codex с предварительно выбранными страницами Function Reference

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

После нажатия "Export" Codex сгенерирует (довольно большой) XML-файл со всем содержимым.

Импорт Codex

Теперь вернитесь к своей локальной установке MediaWiki. Теперь можно импортировать XML-документ и создать локальную "копию" WordPress Codex.

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

10 мар. 2012 г. 02:08:51
Комментарии

Отличный ответ! Я только начал изучать API MediaWiki и даже не знал, что в Codex есть функция экспорта.

Chris_O Chris_O
10 мар. 2012 г. 02:17:38

Некоторые страницы теперь перенесены на developer.wordpress.org, что исключает их из категории Functions. Экспорт категории Functions приведет к отсутствию некоторых страниц (например, get_permalink не будет включен). По моим оценкам, отсутствует примерно 20% контента.

Pim Schaaf Pim Schaaf
8 нояб. 2016 г. 16:04:39
5
22

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

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

Скриншот интерфейса ScrapBook с выделенными разделами для сохранения

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

14 мар. 2012 г. 00:26:17
Комментарии

Это действительно здорово. Есть ли способ передать список URL-адресов для сохранения и последующего просмотра? И можно ли как-то сказать "обнови этот список URL-адресов"?

artlung artlung
14 мар. 2012 г. 00:57:12

Да, а что касается обновления, я пока не уверен.

Bainternet Bainternet
14 мар. 2012 г. 01:39:59

Только что попробовал, и там есть функция повторного сохранения.

Bainternet Bainternet
14 мар. 2012 г. 01:46:09

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

artlung artlung
16 мар. 2012 г. 02:21:15

Есть ли возможность поиска по сохранённым страницам?

User User
1 авг. 2014 г. 03:16:59
4
10

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

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

20 нояб. 2013 г. 15:03:34
Комментарии

Я разработчик Dash. Я обновляю документацию WordPress каждый раз, когда выходит новая версия WordPress.

bogdansrc bogdansrc
14 мая 2014 г. 00:34:37

Я один думаю, что Zeal (или Dash) крайне недооценен, и этот ответ должен быть принятым ответом уже сейчас?

Ejaz Ejaz
19 авг. 2015 г. 14:33:00

@Ejay принятый ответ — это тот, который выбрал автор вопроса, так как он сработал для него. :) Это нормально, когда на вопрос есть несколько ответов с разными подходами.

Rarst Rarst
19 авг. 2015 г. 14:51:51

Спасибо, Rarst. Недавно перешел с Mac на Linux, и Zeal — это именно то, что я искал. К слову, bogdansrc, я несколько раз покупал Dash на Mac, и поскольку ты щедро раздаешь docsets, я всегда буду рекомендовать его разработчикам на Mac. ;)

corysimmons corysimmons
13 янв. 2017 г. 03:16:23
0

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

12 авг. 2010 г. 22:37:44
3

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

12 авг. 2010 г. 18:06:29
Комментарии

:-/ Должен же быть способ получше. Но всё равно спасибо за ответ. Надеюсь, найдётся другое решение!

artlung artlung
12 авг. 2010 г. 18:16:53

есть что-то похожее для мака?

Mild Fuzz Mild Fuzz
11 окт. 2010 г. 11:35:55

Есть приложение BlueCrab, которое делает что-то подобное, но я не могу сказать ничего о его использовании, так как сам им не пользовался.

Keith S. Keith S.
12 окт. 2010 г. 21:33:28
4

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

10 мар. 2012 г. 02:15:05
Комментарии

Можно ли сохранить в статический набор HTML или мне нужно запускать Apache/PHP (или текущие требования MediaWiki) на целевом устройстве? В деталях реализации отсутствует простой набор инструкций, вместо этого они ссылаются на другие решения в различной степени завершенности. http://www.sciencemedianetwork.org/wiki/Mediawiki_mirror#Implementation_details

artlung artlung
10 мар. 2012 г. 02:25:51

Если вы используете это для локальной разработки WordPress, то у вас уже запущен Apache/PHP, и вы соответствуете требованиям для локального запуска MediaWiki.

EAMann EAMann
10 мар. 2012 г. 17:57:06

@EAMann на самом деле я знаю несколько человек, использующих IIS, но я понимаю вашу точку зрения. Еще раз повторю, что в приложенных инструкциях не хватает деталей. Там нет готового "рецепта" для фактического запуска резервной копии.

artlung artlung
14 мар. 2012 г. 02:15:56

Запуск MediaWiki под IIS — это совершенно отдельная тема. Но я понимаю вашу точку зрения. Даже на Windows-машине я бы просто установил XAMPP или аналогичное решение для локального запуска.

EAMann EAMann
14 мар. 2012 г. 03:13:51
0

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

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

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

1 окт. 2019 г. 09:53:50
0

Отличная идея,

Есть несколько способов сделать её "локальной".

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

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

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


Я напишу позже сегодня вечером. Возможно, у меня уже скоро всё будет готово.

Я выложу это на GitHub.

Обновление: Решение с MediaWiki — это правильный способ сделать это.

10 мар. 2012 г. 01:32:06