Есть ли в WYSIWYG редактор Perl Pod? - PullRequest
10 голосов
/ 29 января 2010

Существует ли простой в использовании редактор "что видишь, то, что ты получишь" для Pod?

Я еще не привык к синтаксису Pod, поэтому возможность написать Pod и сразу увидеть, как будет выглядеть вывод, очень поможет. В идеале этот редактор должен иметь своего рода «завершение кода», чтобы помочь с правильным синтаксисом.

Есть ли такой редактор?

Ответы [ 4 ]

5 голосов
/ 29 января 2010

Нет, по крайней мере, я никогда не слышал шепот. Pod - очень простая форма разметки; это не должно занять много времени.

Тем не менее, любой приличный текстовый редактор должен быть настраиваемым для распознавания директив Pod и применения к ним подсветки синтаксиса. Если ваш редактор выполняет завершение кода по ключевым словам, вы тоже это получите. (Примечание: завершение кода не относится к гипотетическому редактору WYSIWYG.)

Что касается просмотра вывода, то нет стандартного способа рендеринга Pod. Он может быть представлен как простой текст, HTML или что-то еще, для чего кто-то был написан переводчиком. В зависимости от вашего текстового редактора вы можете добавить «пользовательскую команду», чтобы перевести текущий документ и показать его в соответствующей программе просмотра. Например, запустите его через pod2html и откройте получившуюся страницу в Firefox.

Редактировать: Советы по написанию Pod раздел perlpod говорит

Если вы более знакомы с письмом в HTML, чем при написании в Pod, вы можете попробовать свои силы в написании документация в простом HTML и превращая его в Pod с экспериментальный Pod :: HTML2Pod модуль

, что позволит вам использовать WYSIWYG HTML-редактор для написания документации. (По крайней мере, в принципе; многое будет зависеть от того, какой вывод произведет редактор.)

1 голос
/ 13 апреля 2018

POD Web View позволяет загружать POD-файл, получать его с URL-адреса или вставлять его содержимое и редактировать его на лету. Сгенерированный HTML может отображаться в выбранном вами стиле, имитируя то, как он будет выглядеть на CPAN, MetaCPAN или GitHub.

Чтобы отдать должное, где это необходимо, бэкэнд построен на Dancer и использует Pod :: Simple :: HTML для генерации предварительного просмотра HTML. Пользовательский интерфейс сделан с помощью Twitter Bootstrap, большого количества кода JavaScript / jQuery и потрясающего редактора Ace.

до Github

1 голос
/ 14 марта 2011

Хотя это и не редактор, Gtk2 :: Ex :: PodViewer - отличный просмотрщик POD GUI на основе GTK. Его можно легко использовать и в Windows благодаря привязкам Camelbox GTK (http://code.google.com/p/camelbox/). Установщик Camelbox выходит из коробки с полнофункциональной оболочкой для Gtk2 :: Ex :: PodViewer.

1 голос
/ 31 января 2010

На CPAN есть незавершенное приложение :: Wx :: PodEditor .

...