man page (Indonesia) - ArchWiki

# man page (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 man-pages`.

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 man-pages`.

## 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

The factual accuracy of this article or section is disputed.

Reason: How is this dynamic? If you later resize the terminal window, the line breaks will still become wrong. (Discuss in Talk:Man page (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

#### mdocml

Pasang mdocmlAUR 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
- Debian GNU/Linux man pages
- DragonFlyBSD manual pages
- FreeBSD Hypertext Man Pages
- Linux and Solaris 10 Man Pages
- Linux man pages at die.net
- The Linux man-pages project at kernel.org
- NetBSD manual pages
- Mac OS X Manual Pages
- On-line UNIX manual pages
- OpenBSD manual pages
- Plan 9 Manual — Volume 1
- Inferno Manual — Volume 1
- Storage Foundation Man Pages
- The UNIX and Linux Forums Man Page Repository
- Ubuntu Manpage Repository

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).

- 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:

- archlinux(7)
- mkinitcpio(8)
- pacman(8)
- pacman-key(8)
- pacman.conf(5)

## Lihat juga

- man page - Gentoo wiki article
- Setting colors for less dan solving related problems (thread di StackExchange)
- Write The Fine Manual with pod2man

Category:

- System administration (Indonesia)

Hidden categories:

- Pages or sections flagged with Template:Accuracy
- Pages with broken section links