Bagaimana cara saya menulis halaman manual?
Di mana saya dapat menemukan referensi semua kode pemformatan?
Apakah ada tutorial bagus tentang cara menulis halaman manual?
Apa cara paling nyaman untuk menulis halaman manual? Haruskah saya memasukkannya langsung ke editor teks? Apakah ada editor WYSIWYG? Atau haruskah saya menulisnya dalam format yang berbeda dan kemudian mengonversi?
Aturan apa yang harus diikuti oleh halaman manual yang baik?
documentation
amarillion
sumber
sumber
man man
,man groff
.Jawaban:
Berikut adalah beberapa halaman web yang akan membantu Anda memulai:
Beberapa alat yang berguna:
sumber
Ada alat untuk menulis halaman manual yang memotong pemformatan troff. manual adalah bahasa yang kecil, dibatasi dengan baik, dan mudah ditargetkan.
Dua alat yang populer adalah:
yodl dan zoem tampaknya merupakan format bagus lainnya di ruang ini.
Semua dalam semua, saya akan merekomendasikan xmltoman karena ini adalah dsl spesifik halaman manual yang akan memandu Anda dengan cermat.
sumber
Saya telah menulis artikel blog yang agak luas tentang topik ini, yang dapat Anda temukan di sini:
sumber
Saya tidak tahu ide atau tutorial apa pun, tetapi Anda bisa mulai dengan menyalin halaman manual yang ada dan memodifikasinya sesuai dengan kebutuhan Anda.
Untuk referensi bahasa groff dengan makro MAN (yang digunakan oleh halaman manual), lihat halaman manual groff_man , atau baca secara online di sini
sumber
Lihatlah proyek ronn . Ini adalah penurunan harga untuk pembuatan halaman manual. Itu juga dapat menghasilkan halaman manual dalam html, seperti ini .
Saya suka ide untuk menulis semua dokumentasi perangkat lunak saya dalam satu format. Penurunan harga IMO adalah pilihan yang baik
sumber