man page (Bahasa Indonesia)

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

man pages—singkatan untuk "halaman panduan" -adalah dokumentasi ekstensif yang telah terpasang dengan hampir semua substansial sistem operasi mirip-UNIX, termasuk Arch Linux. Perintah yang digunakan untuk menampilkannya adalah man.

Terlepas dari ruang lingkupnya, halaman panduan dirancang untuk menjadi dokumen serba lengkap,secara konsekuen membatasi dirinya untuk mengacu ke halaman panduan yang lain ketika membahas subjek terkait. Hal ini sangat kontras dengan info berkas hyperlink-aware, upaya GNU menggantikan format tradisional pada halaman panduan.

less[broken link: invalid section] adalah halaman bawaan yang digunakan dengan man.

Mengakses halaman panduan

Untuk membaca halaman panduan, secara sederhana ketikkan: 

$ man nama_halaman

Panduan-panduan diurutkan menjadi beberapa bagian. Untuk daftar lengkapnya, lihat bagian berjudul "Sections of the manual pages" in man-pages(7).

Halaman panduan biasanya dirujuk berdasarkan namanya, diikuti dengan jumlah bagiannya dalam tanda kurung. Sering kali ada beberapa halaman panduan dengan nama yang sama, seperti man(1) dan man(7). Dalam hal ini, memberikan nomor bagian pada man yang diikuti dengan nama halaman panduan, misalnya: 

$ man 5 passwd

untuk membaca halaman manual pada /etc/passwd, darpiada utilitas passwd.

Deskripsi satu-baris (one-line) dari halaman panduan dapat ditampilkan dengan menggunakan perintah whatis. Misalnya, untuk penjelasan singkat dari bagian halaman panduan mengenai ls, ketik: 

$ whatis ls
ls (1p)              - list directory contents
ls (1)               - list directory contents

Format

Semua halaman panduan mengikuti format yang cukup standar, yang membantu dalam melakukan navigasi pada halaman panduan. Lihat bagian yang berjudul "Sections within a manual page" dalam man-pages(7).

Mencari panduan

Walaupun utilitas man memungkinkan pengguna untuk menampilkan halaman panduan, dan mencari isinya melalui less, masalah muncul ketika pengguna mengetahui bahwa bukan nama yang tepat dari halaman panduan yang diinginkan! Untungnya, opsi -k atau opsi --apropos dapat digunakan untuk mencari deskripsi halaman panduan pada kasus kata kunci tertentu.

Fitur penelitian disediakan oleh cache yang didedikasikan. Secara bawaan, Anda mungkin tidak memiliki cache apapun yang dibangun dan semua pencarian Anda, akan memberi Anda hasil nothing appropriate (yang tidak tepat). Anda dapat membuat atau memperbarui cache dengan menjalankan perintah 

# mandb

Anda harus menjalankan perintah tersebut, setiap kali halaman panduan baru terpasang.

Sekarang Anda dapat memulai pencarian Anda. Misal, untuk mencari halaman panduan yang berkaitan dengan "password": 

$ man -k password

atau: 

$ man --apropos password

Hal ini sama dengan memanggil perintah apropos: 

$ apropos password

Kata kunci yang diberikan diinterpretasikan sebagai ekspresi reguler secara bawaan.

Jika Anda ingin melakukan pencarian yang lebih mendalam dengan menyesuaikan kata kunci yang ditemukan di seluruh artikel, Anda dapat menggunakan opsi -K: 

$ man -K password

Halaman panduan berwarna

Lihat Color output in console#man.

Lebar halaman dinamis

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: How is this dynamic? If you later resize the terminal window, the line breaks will still become wrong. (Discuss in Talk:Man page (Bahasa Indonesia))

Lebar halaman panduan dikendalikan oleh variable konfigurasi MANWIDTH.

Jika jumlah kolom pada terminal terlalu kecil (misal lebar layarnya sempit), jeda baris akan tidak akurat. Hal ini dapat sangat mengganggu ketika dibaca. Anda dapat memperbaiki hal ini dengan mengatur MANWIDTH pada invokasi man. Dengan Bash, akan menjadi seperti berikut: 

~/.bashrc
man() {
    local width=$(tput cols)
    [ $width -gt $MANWIDTH ] && width=$MANWIDTH
    env MANWIDTH=$width \
    man "$@"
}

Jangan ragu untuk mengombinasikan fungsi ini dengan color settings[broken link: invalid section].

Membaca halaman panduan lokal

Sebagai ganti antarmuka yang standar, menggunakan peramban seperti lynx dan Firefox untuk melihat halaman panduan yang memungkinkan pengguna mendapatkan manfaat utama halaman informasi dari teks hyperlink. Alternatifnya meliputi sebagai berikut:

  • Para pengguna KDE dapat membaca halaman panduan di Konqueror menggunakan man:<name>.
  • xorg-xman menyajikan tampilan halaman panduan yang terkategorikan pada X.
  • Bantuan Peramban (Help Browseer) GNOME yelp dapat digunakan melalui yelp man:<name>.

Mengonversi ke mode halaman HTML peramban

mandoc

Pasang mandoc dari AUR. Untuk mengonversikan sebuah halaman, misalnya free(1): 

$ gunzip -c /usr/share/man/man1/free.1.gz | mandoc -Thtml -Ostyle=style.css 1> free.html

Buka berkas yang bernama free.html pada peramban Anda.

man2html

Pertama, pasang man2html dari repositori resmi.

Lalu, konversikan halaman panduan: 

$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

Penggunaan lain dari man2html adalah mengonversi ke berkas raw, teks yang kompatibel dengan mesin cetak: 

$ man free | man2html -bare > ~/free.txt

man -H

Implementasi GNU pada pandual di dalam repositori Archjuga juga memiliki kemampuan untuk melakukan hal tersebut dengan cara: 

$ man -H free

Hal ini akan membaca BROWSER environment variable Anda untuk menentukan peramban. Anda dapat mengganti ini dengan cara melewati biner ke opsi -H.

roffit

Pertama-tama pasang roffitAUR dariAUR.

Untuk mengonversi halaman panduan: 

$ gunzip -c /usr/share/man/man1/free.1.gz | roffit > free.html

Mengonversi ke PDF

Halaman panduan selalu bisa dicetak: ditulis dalam troff, yang pada dasarnya merupakan suatu bahasa penyusunan huruf (typesetting). Jika Anda telah memasang ghostscript, mengonversi sebuah halaman panduan ke PDF sangatlah mudah: man -t <manpage> | ps2pdf - <pdf>. Berikut hasil dari pencarian gambar google memberikan Anda gambaran akan terlihat seperti apa hasilnya; mungkin bukan kesukaan semua orang.

Caveats: Huruf-huruf umumnya terbatas pada Times dengan ukuran hardcoded. Tidak ada hyperlink. Beberapa halaman panduan didesain khusus untuk tampilan terminal, dan tidak akan terlihat baik pada format PS atau PDF.

Berikut skrip dalam bahasa perl untuk mengonversi halaman panduan ke PDF, penyimpanan sementara PDF di dalam direktori $HOME/.manpdf/, dan secara khusus gunakan penampil PDF, seperti mupdf. 

Usage: manpdf [<section>] <manpage>
#!/usr/bin/perl
use File::stat;

$pdfdir = $ENV{"HOME"}."/.manpdf";
-d $pdfdir || mkdir $pdfdir || die "can't create $pdfdir";
$manpage = $ARGV[0];
chop($manpath = `man -w $manpage`);
die if $?;

$maninfo = stat($manpath) or die;
$manpath =~ s@.*/man./(.*)(\.(gz|bz2))?$@$1@;
$pdfpath = "$pdfdir/$manpath.pdf";
$pdftime = 0;
if (-f $pdfpath) {
    $pdfinfo = stat($pdfpath) or die;
    $pdftime = $pdfinfo->mtime;
}
if (!-f $pdfpath || $maninfo->mtime > $pdftime) {
    system "man -t $manpage | ps2pdf -dPDFSETTINGS=/screen - $pdfpath";
}
die if !-f $pdfpath;
if (!fork) {
    open(STDOUT, "/dev/null");
    open(STDERR, "/dev/null");
    exec "mupdf", "-r", "96", $pdfpath;
    #exec "acroread", $pdfpath;
}

Halaman Panduan berbasis Online

Ada beberapa basis datas halaman panduan yang berbasis online, termasuk:

Warning: Beberapa distribusi menyediakan halaman panduan yang telah di-patch atau sudah usang yang berbeda dari yang disediakan oleh Arch. Hati-hati saat menggunakan panduan secara online.

Halaman panduan penting

Berikut daftar non-komplit dari halaman penting yang dapat membantu Anda memahami banyak hal secara lebih mendalam. Beberapa dari daftar di bawah ini dapat menjadi referensi yang bagus (seperti tabel ASCII).

Secara lebih umum, lihatlah kategori 7 pada halaman panduan: 

$ man -s 7 -k ".*"

Halaman khusus Arch Linux:

Lihat juga