webolator 0.1.0__py3-none-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,109 @@
1
+ Metadata-Version: 2.4
2
+ Name: webolator
3
+ Version: 0.1.0
4
+ Classifier: Development Status :: 4 - Beta
5
+ Classifier: Environment :: Console
6
+ Classifier: Intended Audience :: Developers
7
+ Classifier: License :: OSI Approved :: MIT License
8
+ Classifier: Operating System :: OS Independent
9
+ Classifier: Programming Language :: Rust
10
+ Classifier: Topic :: Documentation
11
+ Classifier: Topic :: Text Processing :: Markup :: Markdown
12
+ Classifier: Topic :: Utilities
13
+ License-File: LICENSE
14
+ Summary: Zero-config markdown to website: folder or single file, mermaid, syntax highlighting, single-file HTML output
15
+ Keywords: markdown,static-site,mermaid,documentation,cli
16
+ Author-email: Ville Vainio <vivainio@gmail.com>
17
+ License: MIT
18
+ Requires-Python: >=3.10
19
+ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
20
+ Project-URL: Homepage, https://github.com/vivainio/webolator
21
+ Project-URL: Repository, https://github.com/vivainio/webolator
22
+
23
+ # webolator
24
+
25
+ Turn a folder of markdown, or a single `.md` file, into a browsable website. No config file, no index file, no `SUMMARY.md`.
26
+
27
+ - **Zero config.** Point it at a folder and the navigation comes from the directory tree. Page titles come from the first `# heading`.
28
+ - **Mermaid.** ```` ```mermaid ```` blocks become diagrams, rendered in the browser.
29
+ - **Syntax highlighting** happens at build time (syntect), with light and dark themes and no JavaScript.
30
+ - **Cross-file links work.** `other.md`, `dir/`, `../x.md#some-heading` and `/root/relative.md` are rewritten to the right pages and anchors. Broken links print a warning.
31
+ - **Sibling files are kept.** Raw `.html`, `.txt`/`.log`/code files, PDFs and images are copied and linked. HTML, text and PDF files also appear in the sidebar.
32
+ - **`--single`** writes one self-contained `.html` with everything embedded (images, text files, HTML files, PDFs), which is easy to email or attach.
33
+ - **`--serve`** runs a local preview with live reload.
34
+ - GitHub-flavored markdown: tables, task lists, footnotes, strikethrough, autolinks and `> [!NOTE]` alerts.
35
+ - Light and dark mode follow the OS setting.
36
+
37
+ ## Installation
38
+
39
+ ### Using uv (easiest)
40
+
41
+ Install the published wheel from PyPI as a standalone tool:
42
+
43
+ ```bash
44
+ uv tool install webolator
45
+ ```
46
+
47
+ This puts the `webolator` command on your PATH. To try it without installing anything:
48
+
49
+ ```bash
50
+ uvx webolator docs/ --serve
51
+ ```
52
+
53
+ ### Pre-built binaries
54
+
55
+ Download the latest release for your platform from the [GitHub Releases](https://github.com/vivainio/webolator/releases) page:
56
+
57
+ - **Linux (x86_64)**: `webolator-linux-x86_64.tar.gz`
58
+ - **Windows (x86_64)**: `webolator-windows-x86_64.zip`
59
+ - **macOS (Intel)**: `webolator-macos-x86_64.tar.gz`
60
+ - **macOS (Apple Silicon)**: `webolator-macos-arm64.tar.gz`
61
+
62
+ Extract the archive and place the `webolator` binary in your PATH.
63
+
64
+ ### From source
65
+
66
+ ```bash
67
+ cargo install --git https://github.com/vivainio/webolator
68
+ ```
69
+
70
+ ## Usage
71
+
72
+ ```bash
73
+ webolator docs/ # static site in ./site
74
+ webolator docs/ -o public # ...or somewhere else
75
+ webolator docs/ --single # one self-contained docs.html
76
+ webolator notes.md --single # a single file, plus anything it links to
77
+ webolator docs/ --serve # http://127.0.0.1:8000 with live reload
78
+ ```
79
+
80
+ Try it on the bundled demo:
81
+
82
+ ```bash
83
+ cargo run -- examples/demo --serve
84
+ ```
85
+
86
+ ### How the site is put together
87
+
88
+ | Source | Result |
89
+ |---|---|
90
+ | `index.md` or `README.md` in a folder | that folder's `index.html` |
91
+ | folder with no index | a generated listing page |
92
+ | `foo.md` | `foo.html` (or `foo.md.html` if a raw `foo.html` already exists) |
93
+ | any other file | copied as is |
94
+ | hidden files and folders, `node_modules`, `target`, `venv` | skipped |
95
+
96
+ If you pass a **single file**, webolator follows its local links, including links to parent folders. The site then contains that file, which becomes the home page, plus everything reachable from it.
97
+
98
+ In **`--single` mode**, each page becomes a section with hash routing, so the back and forward buttons and deep links like `docs.html#p-guide-install--setup` work. Images are inlined. Linked HTML files are shown in an iframe and text files as preformatted text, and PDFs and other files open from embedded blobs.
99
+
100
+ ### Mermaid offline
101
+
102
+ By default mermaid.js is loaded from the jsDelivr CDN, and only on pages that contain a diagram. To work fully offline, pass a local copy:
103
+
104
+ ```bash
105
+ webolator docs/ --single --mermaid-js mermaid.min.js
106
+ ```
107
+
108
+ In static mode the file is copied to `_webolator/`. In `--single` mode it is inlined.
109
+
@@ -0,0 +1,6 @@
1
+ webolator-0.1.0.data/scripts/webolator.exe,sha256=gtLbfttR-mput6XTng5qNHW6KYyEXKGhgnkpKAo6neQ,4092928
2
+ webolator-0.1.0.dist-info/METADATA,sha256=sg4pzY_Z-8mlrUWAfK7Fo9l3BG4NZRp58bTf33bicxY,4603
3
+ webolator-0.1.0.dist-info/WHEEL,sha256=8Aej0W0a6Cz6apA3IzJrTnxLRVLAt-w0Oh8SA3Con_c,94
4
+ webolator-0.1.0.dist-info/licenses/LICENSE,sha256=F0DdnhtanxjHuAkXplJcOw1Ur_yto7F-G93mDrRa5Os,1090
5
+ webolator-0.1.0.dist-info/sboms/webolator.cyclonedx.json,sha256=K3V5Wi94It9ZHJIbkZ0PHXaU-U2KoIFvUrHI3x8nQVI,94889
6
+ webolator-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: maturin (1.15.0)
3
+ Root-Is-Purelib: false
4
+ Tag: py3-none-win_amd64
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ville Vainio
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.