Um, buat dan pertahankan halaman manual Ubuntu Anda

tentang um

Pada artikel selanjutnya kita akan melihat Um. Saat ini tidak ada yang bisa meragukan kegunaan halaman manual dan alternatifnya. Alternatif ini digunakan terutama untuk mendapatkan akses contoh khusus, dan dengan demikian tidak harus melalui seluruh halaman manual. Jika Anda mencari cara cepat untuk berkomunikasi atau mempelajari perintah Gnu / Linux dengan mudah, alternatif ini patut untuk dicoba. Um akan mengizinkan kita membuat halaman bantuan kita sendiri untuk sebuah perintah. Ini adalah utilitas terminal, yang sangat berguna untuk membuat dan memelihara halaman manual kita dengan mudah yang hanya berisi apa yang menarik bagi kami.

Dengan membuat halaman bantuan Anda sendiri, Anda dapat menghindari banyak "rincian“Dari halaman manual dan memasukkan di dalamnya hanya apa yang diperlukan untuk memperhitungkan kasus yang menarik minat kami. Jika Anda pernah menginginkannya buat halaman Man Anda sendiri, Um pasti akan berguna untuk anda.

Instal Um di Ubuntu 18.04

Um tersedia untuk Gnu / Linux dan Mac OS. Pada saat saya menulis ini, saya baru saja dapat diinstal menggunakan manajer paket Linuxbrew pada sistem Gnu / Linux. Periksa berikut ini artikel jika Anda belum menginstal Linuxbrew di Ubuntu Anda, karena Anda perlu melakukan hal berikut.

Setelah Linuxbrew diinstal, jalankan perintah berikut di terminal (Ctrl + Alt + T) ke instal Um:

Instalasi UM dengan linuxbrew

brew install sinclairtarget/wst/um

Jika semuanya berjalan dengan baik, terminal akan memberi tahu kami bahwa penginstalan telah selesai dengan memuaskan.

Sebelum menggunakannya untuk membuat halaman manual Anda, Anda harus aktifkan penyelesaian bash untuk Um. Untuk melakukannya, buka file Anda ~ / .bash_profile:

vi ~/.bash_profile

Dan, tambahkan baris berikut ke file:

Profil bash um instal linuxbrew

if [ -f $(brew --prefix)/etc/bash_completion.d/um-completion.sh ]; then
. $(brew --prefix)/etc/bash_completion.d/um-completion.sh
fi

Simpan dan tutup file. Sekarang jalankan perintah berikut ke perbarui perubahan:

source ~/.bash_profile

Siap. Sekarang kita dapat membuat halaman manual pertama kita.

Konfigurasi Um

untuk lihat pengaturan saat ini, Lari:

Konfigurasi UM

um config

Dalam file ini, kami akan dapat mengedit dan mengubah nilai opsi seperti tema default, direktori halaman, dan halaman, yang paling kami minati. Katakanlah misalnya jika Anda ingin menyimpan halaman Um yang dibuat di folder Dropbox Anda, cukup ubah nilai direktif direktori halaman dan kirimkan ke folder Dropbox di folder arsip ~ / .um / umconfig menulis di dalamnya.

pages_directory = /home/tu-usuario/Dropbox/um

File ini, jika tidak dibuat, perlu dibuat untuk menyimpan konfigurasi.

Buat dan pertahankan halaman manual Anda sendiri

Katakanlah jika Anda tertarik buat halaman manual Anda sendiri untuk perintah tersebut 'apt', jalankan di terminal (Ctrl + Alt + T):

um edit apt

Perintah di atas akan membuka file template di editor default Anda:

template halaman manual tentang apt yang dibuat dengan um

Editor default saya adalah Vi. Sekarang, kita bisa mulai tambahkan semua yang perlu Anda ingat tentang perintah 'apt' di template ini.

halaman penuh um apt

Seperti yang terlihat pada tangkapan layar di atas, saya telah menambahkan sinopsis, deskripsi, dan beberapa opsi perintah apt, sebagai contoh. Kamu akan bisa tambahkan bagian sebanyak yang Anda inginkan di halaman ini. Pastikan Anda telah memberikan judul yang sesuai dan mudah dipahami untuk setiap bagian. Setelah selesai, simpan dan keluar dari file. Jika Anda menggunakan editor Vi, tekan tombol ESC dan ketik: wq.

Sekarang kamu bisa lihat halaman manual Anda yang baru dibuat menggunakan perintah:

Halaman manual dibuat dengan apt um

um apt

Seperti yang Anda lihat, halaman manual untuk apt terlihat sama dengan halaman manual resmi. Jika Anda ingin mengedit dan / atau menambahkan lebih banyak detail di halaman manual, jalankan kembali perintah yang sama dan tambahkan detail yang Anda inginkan.

um edit apt

Untuk melihatnya daftar halaman manual yang dibuat baru-baru ini menggunakan Um, jalankan di terminal (Ctrl + Alt + T):

um list

Jika tidak Anda tidak lagi membutuhkan halaman tertentu, hapus saja seperti yang ditunjukkan di bawah ini:

um rm dpkg

untuk lihat bagian bantuan dan semua opsi umum yang tersedia, luncurkan perintah:

um tolong

um --help

Semua halaman manual akan disimpan dalam direktori bernama ~ / .um di direktori home Anda. Siapapun yang mau bisa tahu lebih banyak tentang aplikasi ini dalam repositori tempat proyek berada GitHub.


tinggalkan Komentar Anda

Alamat email Anda tidak akan dipublikasikan. Bidang yang harus diisi ditandai dengan *

*

*

  1. Penanggung jawab data: Miguel Ángel Gatón
  2. Tujuan data: Mengontrol SPAM, manajemen komentar.
  3. Legitimasi: Persetujuan Anda
  4. Komunikasi data: Data tidak akan dikomunikasikan kepada pihak ketiga kecuali dengan kewajiban hukum.
  5. Penyimpanan data: Basis data dihosting oleh Occentus Networks (UE)
  6. Hak: Anda dapat membatasi, memulihkan, dan menghapus informasi Anda kapan saja.