Apakah ada editor halaman manual GUI yang tersedia?

19

Saya menemukan format halaman manual sangat menyakitkan untuk ditulis. Apakah ada editor GUI ( WYSIWYG atau WYSIWYM ) yang tersedia untuk mempermudah tugas ini? Saya berharap untuk aplikasi yang menuju halaman manual seperti Kompozer adalah halaman web.

Saya telah mencoba gmanedit tetapi telah menemukan bahwa itu pada dasarnya hanya editor teks dengan beberapa potongan yang mudah tersedia - perlu mengetahui format halaman manual untuk menggunakannya dan area pengeditan hanyalah widget teks.

Sementara saya lebih suka perangkat lunak yang ada di repositori resmi Ubuntu, saya setuju dengan menggunakan metode yang tidak didukung untuk instalasi seperti PPA atau menginstal dari sumber.

dv3500ea
sumber

Jawaban:

9

Dimungkinkan untuk membuat halaman manual menggunakan markup DocBook dan menggunakan alat seperti docbook2x-man untuk membuat output troff. Ada beberapa editor visual ("WYSIWYM" -style) yang tersedia untuk mengedit markup DocBook. Misalnya, Syntext Serna Free berlisensi GPL :

Cuplikan layar menggunakan Syntext Serna Free untuk mengedit entri referensi DocBook

Selain itu, doclifter adalah utilitas untuk mengonversi halaman manual ke DocBook.

Jukka Matilainen
sumber
Setuju, saya menulis halaman manual saya dalam format dokumen. Ini jauh lebih mudah dirawat!
Roger Light
Docbook adalah format terbaik untuk membuat dokumentasi. Setelah file Docbook Anda selesai, dapat dikonversi ke banyak format. XHTML, Man Pages, dll ...
JM Becker
Sepertinya editor yang bagus, tapi sayangnya sepertinya tidak ada versi gratis lagi.
MestreLion
1

Ini merupakan tambahan untuk saran Jukka tentang menggunakan buku catatan dengan alasan utama mengapa saya menyukainya selain lebih mudah untuk menulis dan berurusan dengan:

Anda dapat mengonversinya menjadi file .pot untuk terjemahan yang lebih mudah. Misalnya, membuat .pot (templat bahasa):

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

Kemudian menggabungkan file yang diterjemahkan (.po) kembali ke halaman manual buku panduan bahasa tertentu, dalam hal ini Jerman:

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

Roger Light
sumber
1

Grapse , sebuah webapp HTML5, ditampilkan di Hacker News 2/3 tahun lalu. Ini termasuk pratinjau bawaan dan penyorotan sintaksis.

aidanh010
sumber
Itu terlihat bagus tetapi tampaknya terutama untuk FreeBSD / OSX dan tidak memformat halaman manual Linux dengan benar (misalnya kehilangan spasi paragraf untuk opsi) bahkan ketika beralih ke ANdi kanan atas halaman web.
Cas
0

Ada satu, ManEdit . Namun, saya tidak tahu apakah masih aktif :(

Terima kasih!

crncosta
sumber
Saya juga menemukan satu, yang tampaknya ditinggalkan dan menggunakan GTK 1.x!
Yesaya