bim 0.1.0

A content-first static site generator for blogs, digital gardens, and knowledge bases
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# Code Snippets

The `snippets/` collection is for actual code files, not Markdown.

## Creating Snippets

Place code files directly in `snippets/`:

```
snippets/
  rust/
    vec_dedup.rs
    error_handling.rs
  python/
    data_processing.py
  bash/
    backup_script.sh
```

## Language Detection

Language is detected from file extension:

| Extension | Language |
|-----------|----------|
| .rs | Rust |
| .py | Python |
| .js | JavaScript |
| .ts | TypeScript |
| .go | Go |
| .sh, .bash | Bash |
| .sql | SQL |
| .html | HTML |
| .css | CSS |

## Syntax Highlighting

Snippets are syntax-highlighted using the `syntect` library with the base16-ocean theme.

## URL Generation

File paths become slugified URLs:

```
snippets/rust/vec_dedup.rs    → /snippets/vec-dedup/
snippets/bash/my_script.sh    → /snippets/my-script/
```

Subdirectories are organizational only—they don't appear in URLs.

## Title Generation

The title comes from the filename:

- `vec_dedup.rs` → "vec dedup"
- `error-handling.rs` → "error handling"

## Snippet Backlinks

Snippets fully participate in backlinks. Link to them from blog posts or notes:

```markdown
See my [vector deduplication snippet](/snippets/vec-dedup/).
```

Related: [#snippets] [#code] [#syntax-highlighting] [@documentation]