أفضل طريقة لصفحات الرجل؟

Question

ما هي أفضل طريقة لصفحات الرجل؟ هل يجب أن أكتب باستخدام وحدات ماكرو الرجل القياسية ، أم أن هناك حزمة ذكية متوفرة الآن والتي تأخذ نوعًا من المصدر XML ، ويمكنه إخراج صفحات الرجل ، HTML ، ASCII ، وماذا لا؟

شكرًا

Answer 1

لاجلي atinout البرنامج الذي كنت أستخدمه رون مما يتيح لك كتابة صفحات الرجل في تخفيض قابلة للقراءة للغاية مثل بناء الجملة. أنا سعيد للغاية معها.

atinout(1) -- Send AT commands to modem, capturing the response
===============================================================

## SYNOPSIS

`atinout` <input_file>|`-` <modem_device> <output_file>|`-`<br>
`atinout` `--version`<br>
`atinout` `--usage`<br>
`atinout` `--help`<br>

## DESCRIPTION

**Atinout** reads a list of AT commands. It sends those commands one by one
to the modem, waiting for the final result code for the
currently running command before continuing with the next command in
the list. The output from the commands is saved.
...

انظر الصفحة بأكملها هنا.

Answer 2

سبق أن استخدمت إصدار GNU من NROFF يدعى Groff لكتابة صفحات MAN.

مقالة مقدمة لطيفة هنا:

http://www.linuxjournal.com/article/1158

Answer 3

Doxygen هو ما تبحث عنه. ضع في اعتبارك أنه مصمم لتوثيق رمز المصدر ولكن يمكنك تكييفه بسهولة.

يمكن أن يولد وثائق HTML و PDF و LaTeX أيضًا.

Answer 4

إذا كنت تبحث في الكتابة مرة واحدة وتوليد تنسيقات إخراج مختلفة مثل Manpages أو HTML أو TXT Plain أو حتى PDF ، ثم docbook يجب أن تعمل بشكل أفضل.

Answer 5

أداة شائعة الاستخدام في مجتمع TCL الدكتوراه والتي يمكن أن تنتج مجموعة فرعية مقيدة (ولكن مفيدة) من تنسيق MinPage ، مناسبة لتقديم مع Groff أو NROFF. يمكنه أيضًا إنشاء نص عادي و HTML مباشرة.