From 7d7ac662a2775b668fcc12cece6d38831c1728e6 Mon Sep 17 00:00:00 2001 From: hffqyd Date: Sat, 4 Mar 2023 06:02:15 +0800 Subject: [PATCH] Saving via a Minimal Web Server (#7315) A standalone mini web server enables support tiddlywiki as well as upload files/images, for use like `[img[images/uploaded.jpg]]`. --- .../Saving via a Minimal Web Server.tid | 49 +++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 editions/tw5.com/tiddlers/saving/Saving via a Minimal Web Server.tid diff --git a/editions/tw5.com/tiddlers/saving/Saving via a Minimal Web Server.tid b/editions/tw5.com/tiddlers/saving/Saving via a Minimal Web Server.tid new file mode 100644 index 000000000..5bbf79485 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Saving via a Minimal Web Server.tid @@ -0,0 +1,49 @@ +caption: tw5-server +color: #70c9a0 +community-author: hffqyd +created: 20230302011710789 +delivery: Server-side Script +description: Web server for saving and uploading +method: save +modified: 20230302055929311 +tags: Android Chrome Firefox [[Internet Explorer]] Linux Mac Opera Safari Saving Windows iOS Edge +title: Saving via a Minimal Web Server +type: text/vnd.tiddlywiki + +A local server for TiddlyWiki5 that saves and backups wikis, inspired by +[[tw5-server.rb | https://gist.github.com/jimfoltz/ee791c1bdd30ce137bc23cce826096da]]. + +tw5-server provides features of: + +* Server for TiddlyWiki5, as well as other files (e.g. images used in TW5 `[img[images/*.png]]`); +* Easy to save wiki via browsers; +* Backup wiki in compress format (.gz), to save disk space; +* Auto clean backups: keep one newest per previous month, keep all backups in current month. +* Upload files/images to server, for use in tiddlywiki as external links. +* Offer binary executable for Linux, macos and windows. + +Download executable script and binary at the github.com [[tw5-server|https://github.com/hffqyd/tw5-server]]. + +! Usage + +```bash +# python script: +python tw5-server.py -p 8000 -d ./ -b backup_dir + +# binary file: +tw5server -a:192.168.0.10 -p:8000 -d:./ -b:backup + +-h usage help +-a address, defautl localhost +-p port, default 8000 +-d directory to servering, default `current dir` +-b backup directory name, default `backup` +-l log saving messages to stdout + +Backups auto-clean strategy: +Keep all backups in current month, keep only the newest one for previous months. +``` + +In Unix/Linux, just excute `./tw5-server.py` (with `chmod +x tw5-server.py`). + +Then go to http://localhost:8000 (or other address:port specified in command) in your web browser, and click on your wiki html file.