Источники информации/человека/доктора/и т.д. Дистрибутива Linux

Я в настоящее время строю всесторонний веб-сайт документации открытого исходного кода мультидистрибутива/проекта/источника/OS.

В данный момент из-за преобразования обрабатывают необходимый, чтобы стать довольным от, не будучи непочтительным (скала страниц справочника), но, тайный формат стандартных страниц справочника, я на уровне 15 ГБ текста и роста.

Должны быть более современные исходные форматы, от которых я могу получить содержание страницы справочника. Devs все еще не пишут 50 годам *roff файл формата для документации, не так ли?

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

Места я надеюсь, все еще не используют древний *roff базирующиеся файлы доктора:

  • FreeBSD
  • NetBSD
  • OpenBSD
  • Debian
  • Ubuntu
  • хинду
  • Арч
  • Slackware (я мог на самом деле использовать лучший источник для slackware 'докторов' docs.slackware.com, 'довольно анемичный' по сравнению с другими дистрибутивами)
  • SUSE
  • Red Hat Enterprise Linux

Таким образом, как программист, который потратил далеко к большому количеству времени, борясь с глупым groff-mandoc 'файл'-T ошибки HTML в основанных на OS компаниях файла докторов, я нуждаюсь в помощи и обращаюсь к ТАК.

Выбор 1 альтернативен намного больше разбора дружественные источники для содержания доктора.

Выбором 2 являются лучшие способы переформатировать содержание страницы справочника, чем управление

find . -type f -exec sh -c 'cd $(dirname "$0") && groff -mandoc "$0" -T html > "$0.html"' {} \;

или

find . -type f -exec sh -c 'cd $(dirname "$0") && man2html "$0" > "$0.html"' {} \;

and hoping I dont get a single errили in several thousand files. All of that is also pretty much throwing away Unicode multilingual suppилиt.

If searching Google fили technical content involving the wилиds 'man' and 'documentation' wasn’t a nearly useless endeavour I may have found a solution myself but they are so here I am.

1
nl ja de
Эй, Добро пожаловать в ТАК! Обратите внимание, что я удалил введение, и taglike/joke формируют конец. Таким образом, вопрос соответствует ТАК Формат Вопросов и ответов. stackoverflow.com/faq
добавлено автор istepaniuk, источник
Спасибо:), Если только жизнь позволила вам удалить неловкие введения впоследствии так легко:)
добавлено автор Techdragon, источник
Спасибо:), Если только жизнь позволила вам удалить неловкие введения впоследствии так легко:)
добавлено автор Techdragon, источник

2 ответы

Я не знаю, получаю ли я вашу фактическую проблему.

Но сегодня многие страницы справочника активно сохраняемых проектов создаются из DocBook (XML) источники, которые могут быть найдены в источнике tarballs различных проектов. Таким образом, они пишутся и сохраняются в XML.

Те файлы DocBook преобразовываются инструментами как xmlto (или docbook2man ), чтобы создать страницы справочника или страницы HTML или PDF.. и т.д.

2
добавлено

Я не знаю, получаю ли я вашу фактическую проблему.

Но сегодня многие страницы справочника активно сохраняемых проектов создаются из DocBook (XML) источники, которые могут быть найдены в источнике tarballs различных проектов. Таким образом, они пишутся и сохраняются в XML.

Те файлы DocBook преобразовываются инструментами как xmlto (или docbook2man ), чтобы создать страницы справочника или страницы HTML или PDF.. и т.д.

2
добавлено
Linux Help
Linux Help
2 686 участник(ов)

Правила: https://telegra.ph/Pravila-Linux-Help-10-15

Linux Security
Linux Security
652 участник(ов)

Данная группа принципиально про безопасность и в частности про безопасность Linux. Прочие темы просим обсуждать в профильных чатах.

pro.bash
pro.bash
123 участник(ов)

All about Nix shells, signals, processes and development in general.

Linux Gaming RUS
Linux Gaming RUS
28 участник(ов)

Русскоязычный чатик, посвящённый играм на различных дистрибутивах Linux, а также wine, proton Arch Linux RU @ArchLinuxChatRU Gnome RU @gnome_ru