p6doc — Perl6's «perldoc»

Ссылка на HTML-версию этого документа: https://docs.perl6.org/.

(Если вы просматриваете этот репозиторий через GitHub, отображение может быть частично несогласованным, поскольку используется формат Perl 6 Pod, а GitHub использует Perl 5 POD).

Прогресс перевода на китайский язык

Perl6 FAQ

Спасибо за перевод araraloren

От Perl5 до Perl6: введение

Руководство по переходу с Perl5 на Perl6 — синтаксис

Руководство по переходу с Perl5 на Perl6 — функции

Руководство по переходу с Perl5 на Perl6 — переменные

Руководство по переходу с Perl5 на Perl6 — операторы

Введение в Perl6 для пользователей Ruby

Установка

Этот модуль можно установить с помощью экосистемы модулей Perl6, используя команду:

zef install p6doc

После установки двоичной версии и обеспечения правильного пути выполнения выполните:

p6doc-index build

для создания индекса.

Использование

Можно запустить через каталог установки Rakudo:

./bin/p6doc Str

чтобы просмотреть документацию класса Str, или через

./bin/p6doc Str.split

чтобы увидеть документацию метода split класса Str. Вы можете пропустить часть ./bin, если вы установили этот модуль с помощью Panda или zef. Также можно выполнить:

p6doc -f slurp

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

Создание HTML-документации

В каталоге вашего проекта выполните следующие команды для установки зависимостей:

zef --deps-only install .

panda installdeps . # panda zef --depsonly install . # zef

Если вы используете rakudobrew, вы также можете обновить каждый модуль, выполнив:

rakudobrew rehash

Также необходимо установить graphviz для создания различных графиков. На Debian-системах это можно сделать с помощью команды:

sudo apt-get install graphviz

Создайте веб-страницу документации с помощью следующей команды:

$ make html

После создания страницы вы можете просматривать её локально. Запустите приложение Mojo, запустив программу (make run):

$ make run

Теперь вы можете перейти по адресу http://localhost:3000 в браузере для просмотра документации.

Примечание: вам необходимо установить Mojolicious, а также nodejs для реализации подсветки синтаксиса.

Помощь!

Проект Perl6 не является небольшим проектом, и для документации требуется много усилий. Мы благодарны за любую помощь. Вы можете помочь нам различными способами:

• дополнить документацию классов, ролей, методов или операторов;
• добавить примеры использования к существующей документации;
• отредактировать всю документацию;
• использовать GitHub для сообщения о недостающей документации;
• найти TODO с помощью git grep TODO в этом репозитории и документировать их;
• интернационализировать проект (перевести на другие языки).

На странице Проблемы проекта перечислены текущие проблемы и недостающая документация. А в CONTRIBUTING.md кратко объясняется, как начать вносить свой вклад.

Ответы на вопросы:

Вопрос: Почему этот текст не встроен в язык Perl6? Ответ: Есть несколько причин:

1. Этот документ не привязан к конкретной версии и не зависит от какой-либо версии Perl6.
2. Анализ POD и встраивание в код всё ещё не очень стабильны, чтобы избежать влияния на время выполнения.
3. Независимый от Perl6 репозиторий GitHub позволяет большему количеству людей участвовать в редактировании и вносить свой вклад.

Вопрос: Мне нужно импортировать методы из superclasses или roles? Ответ: Нет необходимости. HTML-версия уже включает все методы superclasses и roles, которые можно изучить с помощью скрипта p6doc.

Вопрос: Какая лицензия у этого проекта? Ответ: Весь код и документация основаны на Artistic License 2.0. Смотрите полный текст лицензии в файле LICENSE.

Версия

Я хочу, чтобы p6doc и doc.perl6.org стали основным ресурсом для получения информации о функциях Perl 6, будь то язык, встроенные типы или процедуры. Я хочу, чтобы он был полезен каждому программисту на Perl 6.

— moritz

Я надеюсь, что p6doc и doc.perl6.org станут главным источником информации о Perl 6 для всех, кто хочет узнать о его особенностях, будь то сам язык, встроенные типы и процедуры. Я надеюсь, что он будет полезен каждому программисту Perl 6 и всем, кому нужна информация о Perl 6. — moritz

Желаемый формат:

• Реализация Perl6 через встраивание P<...> в исходный код в качестве соответствующего входа p6doc, что позволит динамически получать документацию, например, &say.WHY, без необходимости копировать эту документацию в CORE.setting или кодировать её в двоичный файл. Например:

В src/core/IO.pm Rakudo:

#= P<p6doc/&print> sub print(|$) { ... }

#= P<p6doc/&say> sub say(|$) { ... }

#= P<p6doc/&note> sub note(|$) { ... }

LICENSE

Подробности лицензии кода в этом репозитории см. в файле LICENSE.

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

• Библиотеки jQuery и jQuery UI: Copyright 2015 jQuery Foundation и другие участники; MIT License
• Плагин jQuery Cookie: Copyright 2006, 2015 Klaus Hartl & Fagner Brack; MIT License
• Примеры со Stack Overflow MIT License; (ref #1 for 1f7cc4e)