Двуязычная документация по php7.1 для Dash

Как мертвый кодер, самое обычное действие каждый день - это просмотр различных документов API, Вы, должно быть, открыли N окон (HTML, PDF, CHM) одновременно и продолжали переключаться между редактором и документом, верно? Как бы это сказать, я на самом деле ненавижу такие скучные действия, так как же я могу повысить эффективность и уменьшить бесполезные усилия? Позвольте представить вам очень полезный гаджет для Mac: Dash.

Официальный представитель резюмирует его цель в одном предложении: Dash — это браузер документации API и менеджер фрагментов кода. Вы не ошиблись, у него есть только эти две функции, но это действительно та функция, о которой больше всего заботятся программисты (по крайней мере, для меня. Я использовал много подобных инструментов раньше. Не будет преувеличением сказать, что Dash лучший из них все!

скачать Насчет скачивания, все же рекомендую официальный сайт для скачивания(kapeli.com/dash)
Мощные функции просмотра и поиска документов API Предположительно, эта функция наиболее часто используется всеми.Я должен проверять и искать так много деталей API каждый день.Без хорошего инструмента, как я могу справиться с этим своими руками? Окно продолжает резаться вперед и назад, что раздражает! Dash очень хорошо решает эту проблему, интегрируя единое окно. Смотрите скриншот ниже:

На изображении выше показан основной интерфейс браузера API Dash: левая боковая панель представляет собой схему навигации по различным языкам программирования и средам (в зависимости от того, сколько коллекций документов вы загрузили и установили). справа — детали документа, информация очень интуитивно понятна. Вы также можете искать связанные документы API, вводя ключевые слова в поле поиска в левом верхнем углу, что очень похоже на реализацию полнотекстового поиска.Скорость отклика Dash очень высока! Суть в том, что вы можете одновременно запрашивать разные языки и содержимое фреймворка, что действительно удобно. Увидев это, вы можете спросить, в чем разница между переходом к определенному окну документа (например, файлу PDF или CHM) и поиску его с помощью Ctrl + F, разве это не лишнее? На самом деле вы ошибаетесь, Dash может отображать и скрывать окно документа с помощью горячих клавиш, он предоставляет интерфейс настройки, который пользователи могут настраивать сами (я больше привык к alt+space, потому что другие программы редко используют эту комбинацию клавиш):

Dash поставляется с большим количеством документации API, включающей множество основных языков программирования и фреймворков, список очень страшный: ActionScript, Android, C++, Cappuccino, Cocos2D, Cocos3D, Corona, CSS, Django, Groovy, HTML, Java, JavaFX, JavaScript, jQuery, Kobold2D, Lua, MySQL, Node.js, справочные страницы, Perl, PHP, Python, Ruby , Ruby on Rails, Scala, Sparrow, SQLite, Unity 3D, WordPress, XSLT, XUL

И его библиотека документов принимает формат docset. Опытные пользователи могут легко добавлять другие расширенные документы на основе руководств, представленных на веб-сайте. Фактически, когда Dash был впервые выпущен, он поддерживал только просмотр нескольких документов, кажется, что только Java, HTML , CSS и т. д., благодаря постоянному вкладу пользователей и своевременной обратной связи с автором и постепенному расширению, он имеет такой широкий спектр языковой и фреймворковой поддержки. Чтобы добавить документацию по API, откройте интерфейс конфигурации программного обеспечения, перейдите на вкладку Docset, чтобы увидеть список всей встроенной документации, и загрузите ее по мере необходимости (если это документация, созданная вами, дважды щелкните, чтобы импортировать ее в Dash). ):

Вскоре после того, как я впервые столкнулся с php, я скачал php-документ в тире, только английскую версию, php — популярный язык сценариев,Официальный сайт документацииПредусмотрены несколько языковых версий.Изначально я хотел загрузить китайские документы php для dash, сделанные другими в Интернете.Я смог загрузить несколько из них.Меня они не удовлетворили.Я был немного перфекционистом, поэтому я начал сделать один сам Двуязычная версия.

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

Файл docset по сути является папкой, выберите загруженный английский PHP.docset, щелкните правой кнопкой мыши, чтобы отобразить содержимое пакета, и откройте папку.

Продолжайте распаковывать tarix.tgz, и получите другой PHP.docset. Это русская матрешка? Продолжайте отображать содержимое пакета. Взгляните на структуру иерархии каталогов на картинке выше.

Уровень каталога действительно достаточно глубокий.Dash по сути является автономным браузером API-документов.Внутри находится Safari-браузер.Документ по сути html.На картинке ниже страница php-функции abs.(элемент обзора),

Вы также можете открыть страницу в браузере:http://127.0.0.1:50154/Dash/atuxkowm/php.net/manual/en/function.abs.html

Принцип тире заключается в индексации автономных html-файлов.

Можем ли мы оставить исходный индекс без изменений, просто заменив английский html в каталоге на китайский html?Это возможно после тестирования.

Идея осуществимая, но нагрузка действительно не маленькая.В последней версии англоязычного документа 14888 html файлов.Как мне получить соответствующие китайские html файлы?php-документацияОфициальный сайт предоставил,

Красное поле слева на приведенном выше рисунке — это мульти-html-файл, не содержащий пользовательских заметок, а красное поле справа — это chm-файл, содержащий пользовательские заметки (которые можно распаковать в несколько html-файлов). Если подумать, это не совсем соответствует моим требованиям.В китайской версии, которую я хочу, должны быть заметки пользователя, а макет должен соответствовать английской версии.В макете в файле chm отсутствует навигация по цепочкам, и распаковка файла chm тоже очень хлопотно.

Я случайно проверил английскую версию исходного html-файла и обнаружил, что каждый html имеет следующие комментарии

поискHTTrack Website CopierПозже я узнал, что это инструмент для загрузки веб-страниц в автономном режиме на локальное устройство. Первоначальный официальный документ php dash был создан таким образом. Я был взволнован, изучая эту вещь для автономной загрузки, и, наконец, сдался после долгого времени. хотел скачать только китайские документы.Может я не так настроил.Скачанный китайский каталог на самом деле скачал другие языковые версии.Время скачивания далеко,а я не могу дождаться.

Позже, подумав об этом, легко вывести онлайн-имя китайского документа по имени файла html, например: адрес function.abs.html:PHP.net/manual/this/post…

Я придумал идею, заключающуюся в том, чтобы пройтись по каталогу английских документов, получить имя файла, а затем загрузить документ в соответствии с выведенным именем. Конкретный метод загрузки заключается в написании php-скрипта и использовании curl для загрузки веб-страницы.

После долгих отладок и отладок потребовалось много времени, чтобы наконец загрузить китайский документ. Я снова столкнулся с новой проблемой.Многие ссылки в китайском документе указывают на php.После оффлайна это html файл, который не соответствует, а ссылки на стиль все еще указывают на онлайн, поэтому я потратил много время на китайский документ.После регулярного сопоставления и замены, переписывания файлов стилей в автономном режиме и, наконец, добавления взаимных ссылок на документы на китайском и английском языках, создается двуязычная версия документа php dash.

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

Наконец, я сделал последнюю двуязычную версию документа dash для php7.1.ссылка для скачивания