man page (Bahasa Indonesia)
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 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
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.
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:
- Man7.org. Upstream for Arch Linux's man-pages.
- Arch Linux man pages
- Linux man pages at die.net
- Debian GNU/Linux man pages
- Ubuntu Manpage Repository
- DragonFlyBSD manual pages
- FreeBSD Hypertext Man Pages
- NetBSD manual pages
- OpenBSD manual pages
- Linux and Solaris 10 Man Pages
- The Linux man-pages project at kernel.org
- On-line UNIX manual pages
- Plan 9 Manual — Volume 1
- Inferno Manual — Volume 1
- The UNIX and Linux Forums Man Page Repository
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).
- ascii(7)
- boot(7)
- charsets(7)
- chmod(1)
- credentials(7)
- fstab(5)
- hier(7)
- systemd(1)
- locale(1p), locale(5), locale(7)
- printf(3)
- proc(5)
- regex(7)
- signal(7)
- term(5), term(7)
- termcap(5)
- terminfo(5)
- utf-8(7)
Secara lebih umum, lihatlah kategori 7 pada halaman panduan:
$ man -s 7 -k ".*"
Halaman khusus Arch Linux:
- alpm-hooks(5)
- libalpm(3)
- makepkg(8)
- makepkg.conf(5)
- makepkg-template(1)
- mkinitcpio(8)
- pacman(8)
- pacman.conf(5)
- pacman-conf(8)
- pacman-key(8)
Lihat juga
- man page - Gentoo wiki article
- Setting colors for less dan solving related problems (thread di StackExchange)
- Write The Fine Manual with pod2man