Skip to content

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.

Blockquote

tes

tes2

tes3

Strikethrough

strikethrough example

Tasklisks

  • Apples
  • Broccoli
  • Carrots

{{#include guide-this-website.md::}}


  1. This is a footnote. 

  2. A longer footnote. With multiple lines. Third line.