mdbook
simpelnya, mdbook adalah jika kita ingin membuat catatan berupa web, kita cukup menulis lewat markdown, maka secara otomatis dibuatkan websitenya, lalu tinggal diupload ke hosting
mirip seperti CMS tapi versi HTML
ada banyak cara install, salah satunya yang saya gunakan : (ubuntu 20.04)
Cara 1
cara ini kadang gagal :D
install rush :
curl https://sh.rustup.rs -sSf | sh
install cargo :
sudo apt install cargo
install mdbook :
sudo cargo install mdbook
Cara 2 / cara yang paling mudah :
sudo apt install cargo
cargo install --git https://github.com/rust-lang/mdBook.git mdbook
atau cari referensi di internet "install mdbook" jika cara diatas gagal :D, salah satu link referensi ada di bawah
setelah selesai install :
membuat folder :
mkdir tes
cd tes
make init :
mdbook init
maka akan ada 3 item :
book : berisi file keseluruhan/hasil, yang diupload ke hosting
book.toml : berisi configurasi
src : berisi source untuk kita menambah/hapus/mengedit konten, dan mengatur navigasi
compile program : (untuk membuat isi book
)
mdbook build
run : dijalankan jika ingin menggunakan mdbook mode IP
mdbook serve
ada
2021-02-28 10:21:10 [INFO] (warp::server): listening on http://127.0.0.1:3000
lalu copas link http://127.0.0.1:3000
, masukkan di browser
atau dapat masukkan link directory file:///<directory>/book/<file>.html
Configurasi
untuk configurasi pusat ada di /home/<user>/.cargo/git/checkouts/mdbook-468dfae15ac0a68f/536873c
atau tergantung versi mdbooknya
bacaan utamanya ada di dalam folder guide
/ guide/src/format/config.md
/ guide/src/format/theme/README.md
/ src
/ src/theme
salah satu referensi penggunaan mdbook :
link sama saja :D
beberapa syntax
# Markdown tests
Tests for some markdown output.
## Tables
| foo | bar |
| --- | --- |
| baz | bim |
## Footnotes
Footnote example[^1], or with a word[^word].
[^1]: This is a footnote.
[^word]: A longer footnote.
With multiple lines.
Third line.
## Blockquote
> tes
>> tes2
>>> tes3
## Strikethrough
~~strikethrough example~~
## Tasklisks
- [X] Apples
- [X] Broccoli
- [ ] Carrots
{{#include guide-this-website.md::}}
Markdown tests
Tests for some markdown output.
Tables
foo | bar |
---|---|
baz | bim |
Footnotes
Footnote example1, or with a word2.
This is a footnote.
A longer footnote. With multiple lines. Third line.
Blockquote
tes
tes2
tes3
Strikethrough
strikethrough example
Tasklisks
- Apples
- Broccoli
- Carrots
Kosong
web ini menggunakan mdbook, referensi/bacaan/instalasi dapat dibaca di next page :D