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.