I Made Wiryana dan Tedi Heriyanto1
Dokumen ini akan memberikan gambaran singkat, mengenai bagaimana cara menyiapkan dokumen yang akan digunakan dalam proses RFC. Tujuan utama penulisan dokumen ini adalah agar memberikan panduan bagi para penulis dokumen dalam menghasilkan dokumen yang memiliki format seragam, portabel, dan bersifat open.
Beberapa buah tools, misalnya program nroff dan paket makro -ms dan editor vim, yang digunakan dalam pembuatan dokumen RFC semuanya bersifat open source.
Pertama-tama yang perlu dilakukan dalam membuat dokumen adalah menyiapkan dokumen tersebut.
Dokumen yang ditujukan bagi RFC proses ini haruslah diketik dalam lingkungan sistem operasi UNIX2, agar memudahkan proses pemformatan selanjutnya. Untuk melakukan pengetikan ini dapat digunakan teks editor yang umum tersedia di lingkungan sistem operasi UNIX misalnya VIM ataupun Emacs, meski tidak menutup kemungkinan juga untuk menggunakan teks editor lainnya.
Bagi anda yang ingin belajar mengenai teks editor lebih lanjut terdapat banyak sekali tutorial yang beredar di Internet yang membahasnya. Salah satunya adalah tutorial yang dibuat oleh salah satu penulis dokumen ini dan dapat diperoleh di http://www.tedi-h.com/papers/tut-vi.html
Jika anda telah terlanjur mengetik menggunakan MS Word, jangan kuatir, dokumen yang telah anda ketik tersebut masih dapat kita gunakan sebagai dokumen RFC.
Untuk melakukannya diperlukan beberapa langkah sederhana yang mesti dilakukan di dalam lingkungan sistem operasi Windows dan sistem operasi UNIXes:
Dokumen yang telah selesai diketik tadi kemudian disimpan ke dalam sebuah file teks murni.
Untuk memformat dokumen yang telah selesai dibuat tadi, digunakan program nroff. Biasanya program ini sudah terinstalasi secara baku di dalam sistem komputer anda.
GNU Troff (atau nroff) adalah suatu sistem untuk typesetting dokumen. Troff sangat fleksibel dan telah ada (dan digunakan) selama hampir dua dekade. Ia cukup tersebar luas dan sangat dikenal di komunitas UNIX [3].
Secara sederhana, fungsi program nroff adalah menerjemahkan perintah-perintah layout yang dimasukkan dalam suatu file, yaitu file anda. Dengan demikian anda dapat menentukan output tampilan file dokumen anda dengan menggunakan nroff, anda tidak perlu bingung memikirkan bagaimana nanti tampilan dokumen anda karena telah diformat secara konsisten dengan nroff.
Berikut ini adalah beberapa buah kemampuan nroff [3]:
nroff membaca sebuah file input yang disiapkan oleh pemakai dan menghasilkan sebuah file yang sesuai untuk dipublikasikan atau dicetak. Input terdiri dari teks, atau kata-kata untuk dicetak, dan perintah-perintah yang disertakan (permintaan dan escape), yang memberitahu nroff bagaimana memformat salinan tercetak.
Kata argumen digunakan dalam dokumen ini untuk menyatakan kata atau bilangan yang muncul pada baris yang sama dengan sebuah perintah yang memodifikasi arti perintah tersebut. Sebagai contoh, perintah :
.spberarti spasi satu baris, tetapi
.sp 4berarti spasi empat baris
Angka 4 adalah sebuah argumen bagi perintah sp yang menyatakan jumlah spasi empat baris alih-alih satu baris. Argument dipisahkan dari perintah dan satu sama lainnya dengan spasi.
Fungsi utama nroff adalah mengumpulkan kata-kata dari baris input, mengisi baris-baris output dengan kata-kata tersebut, meratakan margin kana dengan menambahkan spasi di baris tersebut, dan memberikan hasilnya.
Sebagai contoh, input:
Now is the time
for all good men
to come to the aid
of their party.
Four score and seven
years ago,...akan dibaca, dipaket ke dalam baris-baris output, dan diratakan sehingga menghasilkan :
Now is the time for all good men to come to the aid of their party. Four score and seven years ago,...Terkadang anda ingin memulai sebuah baris output baru meskipun baris yang sekarang belum penuh, sebagai contoh pada akhir sebuah paragraf. Untuk melakukan ini anda dapat membuat sebuah break, yang memulai sebuah baris baru.
Tidak seluruh baris input adalah teks yang ingin diformat. Beberapa baris input adalah perintah yang menggambarkan bagaimana memformat teks. Perintah-perintah ini selalu dimulai dengan tanda titik atau apostrophe (`'').
Pemformat teks juga melakukan beberapa hal kompleks lainnya, seperti secara otomatis menyisipkan nomor halaman, menempatkan footnode di tempat yang tepat, dan sebagainya.
Cukup basa-basinya mengenai kemampuan nroff, mari kita langsung membahas perintah-perintahnya.
Panjang halaman diset ke n, yang dapat dispesifikasikan dalam sembarang unit: 10.1 i menghasilkan halaman dengan panjang 9 inchi.
Perintah ini digunakan untuk mengeset ofset halaman. Beri nilai 0, untuk mengeset ofset ke paling kiri halaman.
Perintah ini digunakan untuk mengeset panjang halaman. Secara bakunya, nroff mengeset panjang halaman 6,5 inchi.
Sesuaikan kedua buah margin, ini adalah mode penyesuaian baku.
Berikan n baris kosong pada ruang ini dalam output. Jika n dihilangkan, perintah ini menempatkan satu baris kosong (nilai saat ini unit v). Anda dapat memberikan unit dimensi bagi n untuk menspesifikasikan kuantitas dalam unit alih-alih dalam jumlah baris kosong.
Perintah ini digunakan untuk meratatengahkan n baris teks input berikut secara individu dalam output. Jika n dihilangkan, hanya baris berikut teks yang akan diratatengahkan.
Perintah ini digunakan untuk mengeset margin kiri halaman terindentasi sejumlah n dari ofset halaman.
Perintah ini digunakan untuk mengeset indentasi sementara. Secara baku, unit yang digunakan adalah ems.
Beberapa unit pengukuran benar-benar independen dengan setting nroff yang ada saat ini (misalnya ukuran tipe) of nroff.
| Unit | Keterangan |
| i | Inci. Unit pengukuran antik yang masih digunakan di beberapa negara terbelakang tertentu. |
| c | sentimeter |
| p | Poin. Ini adalah ukuran typesetter yang digunakan untuk mengukur ukuran tipe. Ada 72 poin dalam satu inci. |
| P | Pica. Ukuran typesetting yang lain. Ada 6 pica dalam satu inci. |
Ukuran lain yang dikenal oleh nroff adalah dependen dengan setting saat ini. Sangat berguna untuk menspesifikasikan ukuran yang tampak sesuai dengan sembarang ukuran teks.
| Unit | Keterangan |
| m | Em. Unit ini setara dengan ukuran font saat ini dalam point. Disebut demikian karena ia mendekati lebar huruf `m' di font saat ini. |
| n | En. Setengah dari sebuah em. |
| v | Spasi vertikal. Setara dengan spasi baris saat ini. |
| M | 1/100 dari sebuah em. |
Sebuah contoh file yang siap diformat menggunakan nroff dapat diperoleh di http://www.tedi-h.com/projects/rfc/rfcid1000
Sebelum dapat menggunakan nroff, terlebih dahulu anda harus mendownload program fix.pl dari http://www.tedi-h.com/projects/rfc/fix.pl.
Untuk menghasilkan output dari file yang telah diformat tersebut, dapat diberikan perintah berikut ini :
nroff -ms file_input | ./fix.pl > file_output
Demikianlah uraian singkat kami mengenai penggunaan beberapa buah tool untuk membuat dokumen RFC. Kami berharap semoga dokumen ini dapat digunakan demi kepentingan kita bersama.