aboutsummaryrefslogtreecommitdiff
path: root/readme.md
diff options
context:
space:
mode:
authormetamuffin <metamuffin@disroot.org>2022-09-29 16:06:55 +0200
committermetamuffin <metamuffin@disroot.org>2022-09-29 16:06:55 +0200
commitb31b6ff2ab5d94e5b6280ba3cb4db7d46267999a (patch)
treeed3ddb623ffead4a073d8230f31f9640d0d29e20 /readme.md
parent3dbde33c6797c5522929a6b4cc3c62e9f0c27671 (diff)
downloadstaticwiki-b31b6ff2ab5d94e5b6280ba3cb4db7d46267999a.tar
staticwiki-b31b6ff2ab5d94e5b6280ba3cb4db7d46267999a.tar.bz2
staticwiki-b31b6ff2ab5d94e5b6280ba3cb4db7d46267999a.tar.zst
docs
Diffstat (limited to 'readme.md')
-rw-r--r--readme.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..9aa43e5
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,25 @@
+# staticwiki
+
+Yet another low-effort tool for rendering MediaWiki XML dumps to static html
+pages.
+
+## Features
+
+- partial wikitext support
+- can accept bzip2 compressed streams.
+- can output tar stream (could be piped to mksquashfs to recompress without
+ writing to disk)
+- horribly bad code :)
+
+## Usage
+
+- clone repo
+- obtain rustc (tested with nightly)
+- `cargo install --path .`
+- Get help: `staticwiki --help`
+- Convert to squashfs:
+ `staticwiki --bzip2 --tar < dump.xml.bz2 | mksquashfs - wiki.sfs -tar -comp zstd`
+
+## License
+
+`AGPL-3.0-only`