Pengguna Kekuatan BookStack: Cara bekerja lebih cepat di BookStack

BookStack sudah sangat nyaman dalam bentuk standar – tetapi dengan sedikit Pengguna yang kuat‑Triknya, tiba-tiba terasa seperti turbo wiki.
Dalam artikel ini, saya merangkum fungsi-fungsi power user yang paling penting dari dua video resmi, menerjemahkannya menjadi tips praktis dan menambahkan pengalaman saya sendiri untuk penggunaan sehari-hari.

Daftar isi

1. Apa yang membuat BookStack menjadi pengguna yang hebat?
2. Menulis lebih cepat: Pintasan editor, daftar tugas & perubahan format
3. Navigasi lebih baik: remah roti, lampiran & pintasan antarmuka
4. Gunakan kembali konten: konten termasuk, templat halaman & templat buku
5. Telusuri seperti seorang profesional: tag, operator & referensi
6. Kenyamanan dalam kehidupan sehari-hari: pengisian awal login & pelengkapan otomatis email
7. Kiat praktis untuk tim: Beginilah cara pengguna Anda menjadi pengguna hebat BookStack

Apa yang membuat BookStack menjadi pengguna yang hebat?

Pengguna kuat BookStack tidak hanya mengetahui halaman, buku, dan rak, tetapi juga menggunakan:

• Pintasan keyboard di editor dan antarmuka
• Templat, penyertaan, dan templat untuk konten yang dapat digunakan kembali
• Pencarian cerdas dengan tag dan operator
• Fungsi kenyamanan seperti daftar tugas, referensi, dan optimalisasi login

Semua fungsi dalam postingan ini tersedia tanpa plugin di instalasi BookStack saat ini.​

Menulis lebih cepat: Pintasan editor, daftar tugas & perubahan format

Judul, info, dan kode melalui keyboard

Di editor, Anda dapat mempercepat pemformatan secara besar-besaran dengan menggunakan Ctrl (atau Cmd di Mac) plus angka.​

• Ctrl+1 hingga Ctrl+4: Judul dari besar ke kecil
• Ctrl+5: kembali ke paragraf normal
• Ctrl+7: Sisipkan blok kode
• Ctrl+9: Sisipkan info, penekanan berulang akan mengubah jenis info (misalnya catatan, peringatan, kesalahan).

Contoh praktis:
Anda menulis panduan dengan beberapa langkah – alih-alih terus-menerus membuka menu format dengan mouse, Anda mengetik judulnya, menyorotnya, dan menekan Ctrl+2 untuk judul tengah.​

Daftar tugas di editor WYSIWYG

Daftar periksa ideal untuk menampilkan hal yang harus dilakukan dalam suatu halaman, misalnya daftar periksa orientasi atau daftar periksa rilis.​

Begini caranya:

1. Buat daftar normal di editor WYSIWYG
2. Di menu daftar, pilih entri dengan tanda centang – daftar tersebut menjadi daftar tugas
3. Tanda centang dapat diklik di editor; dalam mode membaca mereka tetap hanya-baca

Anda dapat menambah, mengindentasi, atau menggabungkan poin – daftar tugas berfungsi seperti daftar lainnya, hanya dengan status tambahan.​

Beralih antara WYSIWYG dan Penurunan Harga

Banyak tim menggabungkan penulisan visual dengan Markdown. BookStack mendukung perubahan per halaman – dengan dua strategi:​

• “Konten bersih”: mencoba membuat Penurunan Harga sebersih mungkin dari WYSIWYG, namun mungkin kehilangan format (misalnya ukuran gambar).​
• “Konten stabil”: beralih ke editor penurunan harga, namun sebagian besar konten HTML sebelumnya tidak berubah, sehingga pengaturan tata letak dipertahankan.​

Tip:
Gunakan “Konten bersih” untuk halaman sederhana (teks, judul, daftar) dan “Konten stabil” untuk halaman dengan banyak gambar atau format khusus.​

Untuk beralih, Anda memerlukan peran dengan izin untuk mengubah jenis halaman (editor).​

Navigasi lebih baik: remah roti, lampiran & pintasan antarmuka

Remah roti dan Navigasi Turbo

Di bagian atas setiap halaman, BookStack menunjukkan hierarki: Rak → Buku → Bab → Halaman.​
Di samping nama terdapat panah kecil yang dapat Anda gunakan untuk melompat ke “elemen saudara”.​

Contoh:

• Panah di sebelah “Rak”: menampilkan semua rak di sistem
• Panah di sebelah rak saat ini: tampilkan semua buku di rak ini
• Panah di samping buku: tampilkan semua bab dan halaman tepat di bawah buku ini​

Ini menghemat banyak klik melalui navigasi halaman, terutama dalam koleksi pengetahuan yang besar.​

Buka lampiran langsung di browser

Lampiran seperti PDF atau gambar tidak hanya dapat diunduh, tetapi juga langsung ditampilkan di tab baru.​

Selain itu:

1. Untuk lampirannya, klik dropdown kecil di sebelah simbol unduh
2. Pilih “Buka di tab baru”.
3. Anda juga dapat menggunakan tautan yang dihasilkan di konten halaman – izin tetap terikat pada halaman asli.​

Ideal untuk manual internal, formulir, atau diagram yang ingin Anda tautkan sebaris.​

Pintasan keyboard untuk antarmuka

Selain pintasan editor, BookStack juga menawarkan pintasan yang dapat dikonfigurasi untuk navigasi dan tindakan.​​

Pengaktifan:

1. Buka profil di kanan atas
2. Pilih “Pintasan”.
3. Centang “Aktifkan pintasan keyboard”.
4. Tentukan pintasan keyboard untuk tindakan individual (misalnya beranda, penelusuran, edit halaman), seperti Ctrl+1 untuk beranda.​​

Saat pintasan aktif, Anda dapat menekan tombol “?” Tampilkan bantuan overlay kapan saja yang menunjukkan pintasan keyboard mana yang tersedia tergantung pada konteksnya.​​

Gunakan kembali konten: konten termasuk, templat halaman & templat buku

Konten Termasuk: Menampilkan konten dari halaman lain

Dengan Penyertaan Konten, Anda dapat menyertakan konten dari halaman lain secara keseluruhan atau dalam blok.​

Melanjutkan:

1. Sorot bagian dalam sebuah halaman
2. Di popup juga
   • Buat tautan ke blok atau
   • Klik ikon sertakan untuk mendapatkan sintaks penyertaan khusus
3. Rekatkan sintaks ini ke halaman lain, simpan – konten tampak dinamis.​

Poin penting:

• Anda dapat memasukkan seluruh halaman atau blok individual.​
• Penyertaan tidak dapat disarangkan (tidak ada penyertaan di dalam penyertaan) – karena alasan kinerja, kedalamannya hanya satu tingkat.​
• Konten yang terintegrasi tidak terindeks pada teks halaman target, namun hanya terdapat pada halaman asli.​​

Skenario umum:

• “Catatan Umum” atau bagian keselamatan yang identik dalam banyak instruksi
• Definisi standar atau blok glosarium yang harus dipertahankan secara terpusat

Templat halaman: blok penyusun untuk disisipkan

Templat adalah halaman normal yang ditandai sebagai templat dan kemudian muncul di editor sebagai elemen penyusun yang dapat digunakan kembali.​

Beginilah cara templat dibuat:

1. Buat halaman baru dan tentukan struktur/konten (misalnya “templat log server”)
2. Aktifkan kotak centang “Tandai sebagai templat” di sidebar halaman
3. Simpan halaman – sekarang muncul di sidebar template editor.​

Gunakan di editor:

• Templat klik: menggantikan seluruh konten halaman saat ini
• Anda juga dapat melampirkan template di awal atau akhir menggunakan ikon kecil
• Templat dapat diseret dan dilepas ke posisi mana pun dalam teks.​

Banyak tim membuat buku “templat” mereka sendiri, yang hanya boleh diedit oleh segelintir orang, sementara yang lain hanya menggunakan templat tersebut.​

Templat buku (“Buku Templat”) melalui salinan

Untuk struktur berulang di tingkat buku – misalnya “profil pelanggan”, “dokumentasi proyek” – templat buku direkomendasikan:​

Contoh proses:

1. Buat buku “Template Profil Pelanggan” dengan bab dan halaman yang khas
2. Tetapkan izin agar hanya editor yang dapat melihat dan mengedit buku
3. Untuk proyek pelanggan baru, duplikat buku ini menggunakan fungsi “Salin”, sesuaikan nama dan urutkan di rak yang sesuai.​

Dengan cara ini Anda menerapkan struktur yang konsisten tanpa harus memulai dari awal setiap saat.​

Gunakan tag secara sistematis

BookStack mendukung tag di rak, buku, bab, dan halaman.​
Anda dapat menggunakan direktori tag untuk melihat semua tag di sistem dan melihat seberapa sering tag tersebut digunakan dan di mana.​​

Di mana pun tag ditampilkan, Anda dapat:

• Klik pada nama tag: Cari semua konten dengan nama tag tersebut
• Klik pada nilai tag: Telusuri semua konten dengan nama dan nilai tag yang tepat​​

Pencarian tag ini muncul sebagai sintaksis dengan tanda kurung siku di kolom pencarian.​​

Operator tag: lebih besar dari, kurang dari, tidak sama dengan

Segalanya menjadi sangat menarik dengan nilai tag numerik karena Anda dapat menggunakan operator.​

Contoh yang didukung:

• rating=[=2] – Tandai “rating” dengan nilai tepat 2
• rating=[!=2] – Tandai “peringkat” dengan nilai apa pun kecuali 2
• rating=[>2] – Tandai “peringkat” dengan nilai lebih dari 2
• rating=[>=2], rating=[<2], rating=[<=2] – analog dengan operator perbandingan

Untuk nilai tekstual, Anda dapat menggunakan penelusuran “suka” atau “berisi”, misalnya untuk menemukan semua konten yang nilai tagnya diawali dengan string tertentu.​​

Dokumentasi resmi mencantumkan semua kemungkinan operator filter dan opsi pencarian lanjutan lainnya.

Penting:
Sintaks yang diperluas ini berfungsi tidak hanya dalam penelusuran global, namun juga dalam bidang penelusuran kontekstual, seperti penelusuran buku dalam buku tertentu.​​

Referensi konten: Di mana halaman ini tertaut?

BookStack menunjukkan kepada Anda halaman mana halaman atau objek lain yang direferensikannya.​

Pada suatu halaman, Anda akan menemukan entri seperti “Direferensikan pada 2 halaman” di area detail di sebelah kanan dan Anda dapat menggunakannya untuk:

• Lihat semua halaman yang berisi link ke halaman ini
• Telusuri juga referensi dari objek tingkat yang lebih tinggi (misalnya buku → halaman).

BookStack juga menggunakan sistem referensi ini untuk memperbarui tautan secara otomatis ketika URL berubah.​

Contoh:

1. Buku “Konten Hewan” ditautkan dalam satu halaman
2. Anda mengganti nama buku menjadi “Konten hewani saya” – siputnya berubah
3. Tautan pada halaman penautan secara otomatis disesuaikan agar tetap mengarah ke tujuan yang benar.​

Jika Anda memiliki sistem lama yang referensinya belum tercatat di semua tempat, Anda dapat mulai membangun kembali indeks referensi di area pemeliharaan.​

Kenyamanan dalam kehidupan sehari-hari: pengisian awal login & pelengkapan otomatis email

Misalnya saat Anda masuk secara rutin dengan email, Anda dapat menyetel alamat email melalui parameter URL.​

Contoh:

• URL Masuk Normal:
  
• Mit E-Mail-Prefill:
  [email protected]

Jika Anda menyimpan URL ini sebagai bookmark browser, kolom email sudah terisi setiap kali Anda mengunjunginya, Anda hanya perlu memasukkan kata sandi.​

Kiat praktis untuk tim: Beginilah cara pengguna Anda menjadi pengguna hebat BookStack

Dari sudut pandang admin atau manajer dokumentasi, saya merekomendasikan prosedur berikut untuk “Pengguna Kekuatan BookStack”:

• Perkenalkan buku “templat” Anda sendiri dengan templat halaman dan bagian dan batasi akses ke tim dokumentasi kecil.
• Tentukan konvensi penandaan (mis status, system, environment, owner) dan catat penggunaannya dalam panduan gaya.​​
• Periksa indeks referensi secara teratur atau buat ulang selama pemeliharaan jika terjadi renovasi besar.​
• Tampilkan semua fungsi power user secara langsung sekali dalam panggilan tim dan buat halaman “BookStack Power User” Anda sendiri di sistem yang mengumpulkan pintasan, contoh, dan tautan ke dokumentasi resmi.

Jika Anda memerlukan dukungan untuk menyiapkan, mengoperasikan, atau memperkuat instans BookStack Anda sendiri, Anda dapat menemukan informasi lebih lanjut tentang layanan alat sumber terbuka kami di situs web BookStack kami.

​Jika Anda ingin mempelajari BookStack lebih dalam lagi, Anda dapat menemukan petunjuk lebih lanjut dan artikel praktis di kategori BookStack kami di blog.

Tautan lebih lanjut

Untuk topik admin dan dokumentasi lebih lanjut terkait self-hosting, open source, dan infrastruktur TI, ada baiknya melihat blog ADMIN INTELLIGENCE.​