Sono disponibili editor della pagina man della GUI?


19

Trovo il formato della pagina man estremamente doloroso da scrivere. È disponibile un editor GUI ( WYSIWYG o WYSIWYM ) per semplificare questa attività? Spero in un'applicazione che sia alle pagine man come Kompozer alle pagine web.

Ho provato gmanedit ma ho scoperto che è fondamentalmente solo un editor di testo con alcuni frammenti facilmente disponibili: è necessario conoscere il formato della pagina man per usarlo e l'area di modifica è solo un widget di testo.

Mentre preferirei il software che si trova nei repository ufficiali di Ubuntu, sono d'accordo con l'uso di metodi non supportati per l'installazione come PPA o l'installazione dal sorgente.

Risposte:


9

È possibile creare pagine man usando il markup di DocBook e utilizzare strumenti come docbook2x-man per creare output troff. Ci sono alcuni editor visivi (in stile "WYSIWYM") disponibili per la modifica del markup DocBook. Ad esempio, Syntext Serna Free con licenza GPL :

Schermata di utilizzo di Syntext Serna Free per modificare una voce di riferimento di DocBook

Inoltre, doclifter è un'utilità per convertire le pagine man in DocBook.


D'accordo, scrivo le mie pagine man in formato docbook. È molto più mantenibile!
— Roger Light,

Docbook è il formato migliore per la creazione di documentazione. Una volta completato, il tuo file Docbook può essere convertito in una moltitudine di formati. XHTML, Man Pages, ecc ...
— JM Becker,

Sembra un buon editor, ma sfortunatamente sembra che non ci sia più una versione gratuita.
— MestreLion,

1

Questo è un addendum al suggerimento di Jukka di usare docbook con il motivo principale per cui mi piace diverso da quello che è molto più facile da scrivere e gestire:

Puoi convertirlo in file .pot per una traduzione più semplice. Ad esempio, creando un .pot (modello di lingua):

xml2po -o my_program.1.pot my_program.1.xml

Quindi unendo nuovamente i file tradotti (.po) in una pagina man del docbook specifica per la lingua, in questo caso il tedesco:

xml2po -p de.po my_program.xml > my_program.de.xml


1

Grapse , una webapp HTML5, è stata pubblicata su Hacker News 2/3 di un anno fa. Include l'anteprima integrata e l'evidenziazione della sintassi.


Sembra buono ma sembra principalmente per FreeBSD / OSX e non formatta correttamente le pagine man standard di Linux (ad es. Perde la spaziatura dei paragrafi per le opzioni) anche quando si passa a ANin alto a destra della pagina web.
— Cas

Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.