Docs: Copy content from tiddlywiki.com

editions/multiwikidocs/tiddlers/Bags and Recipes.tid

@@ -0,0 +1,41 @@
+created: 20240309135835396
+modified: 20240309142156125
+title: Bags and Recipes
+type: text/vnd.tiddlywiki
+
+The bags and recipes model is a reference architecture for how tiddlers can be shared between multiple wikis. It was first introduced by TiddlyWeb in 2008.
+
+The principles of bags and recipes can be simply stated:
+
+# Tiddlers are stored in named "bags"
+# Bags have access controls that determines which users can read or write to them
+# Recipes are named lists of bags, ordered from lowest priority to highest
+# The tiddlers within a recipe are accumulated in turn from each bag in the recipe in order of increasing priority. Thus, if there are multiple tiddlers with the same title in different bags then the one from the highest priority bag will be used as the recipe tiddler
+# Wikis are composed by splicing the tiddlers from the corresponding recipe into the standard TW5 HTML template
+
+A very simple example of the recipe/bag model might be for a single user who maintains the following bags:
+
+* ''recipes'' - tiddlers related to cooking recipes
+* ''work'' - tiddlers related to work
+* ''app'' - common tiddlers for customising TiddlyWiki
+
+Those bags would be used with the following recipes:
+
+* ''recipes'' --> recipes, app - wiki for working with recipes, with common custom components
+* ''work'' --> work, app - wiki for working with work, with common custom components
+* ''app'' --> app - wiki for maintaining custom components
+
+All of this will work dynamically, so changes to the app bag will instantly ripple into the affected hosted wikis.
+
+A more complex example might be for a teacher working with a group of students:
+
+* ''student-{name}'' bag for each students work
+* ''teacher-course'' bag for the coursework, editable by the teacher
+* ''teacher-tools'' bag for custom tools used by the teacher
+
+Those bags would be exposed through the following hosted wikis:
+
+* ''student-{name}'' hosted wiki for each students work, including the coursework material
+* ''teacher-course'' hosted wiki for the coursework, editable by the teacher
+* ''teacher'' hosted wiki for the teacher, bringing together all the bags, giving them an overview of all the students work
+

editions/multiwikidocs/tiddlers/DefaultTiddlers.tid

@@ -1,3 +1,5 @@
 title: $:/DefaultTiddlers
 
-HelloThere
+HelloThere
+Installation
+Usage

editions/multiwikidocs/tiddlers/HelloThere.tid

@@ -1,3 +1,14 @@
 title: HelloThere
 
-Hello! This is a test
+<span class="tc-float-right">[img width=200 [MWS Banner.png]]</span>
+~MultiWikiServer is a new development that drastically improves ~TiddlyWiki's capabilities when running as server under Node.js. It brings ~TiddlyWiki up to par with common web-based tools like ~WordPress or ~MediaWiki by supporting multiple wikis and multiple users at the same time.
+
+Planned features include:
+
+* Hosting multiple wikis at once, using the [[Bags and Recipes]] mechanism for sharing data between them
+* Robust authentication and authorisation options
+* Improved handling of file uploads and attachments, allowing gigabyte video files to be uploaded and streamed
+* Instantaneous synchronisation of changes between the server and all connected clients
+* Workflow processing on the server, for example to automatically compress images, or to archive webpages
+
+MWS is currently [[under development at GitHub|https://github.com/TiddlyWiki/TiddlyWiki5/pull/7915]] but it is already functional and usable.

editions/multiwikidocs/tiddlers/Installation using Git.tid

@@ -0,0 +1,16 @@
+title: Installation using Git
+modified: 20241105133737778
+created: 20241105133737778
+
+These instructions require basic knowledge both of the terminal and of Git. There are also [[alternative instructions without using Git|Installation]].
+
+# Clone the code from GitHub with: <<.copy-code-to-clipboard "git clone -b multi-wiki-support --single-branch https://github.com/TiddlyWiki/TiddlyWiki5">>
+# Open a terminal window in the root of the downloaded folder
+# Install the dependencies with the command: <<.copy-code-to-clipboard "npm install">>
+# Start the server with the command: <<.copy-code-to-clipboard "npm start">>
+# To use MWS, visit http://localhost:8080 in a browser on the same computer
+# When you have finished using MWS, stop the server with <kbd>ctrl-C</kbd>
+
+To update your copy of MWS with newer changes from ~GitHub, run the following command:
+
+<<.copy-code-to-clipboard "git pull">>

editions/multiwikidocs/tiddlers/Installation.tid

@@ -0,0 +1,14 @@
+title: Installation
+modified: 20241105133737778
+created: 20241105133737778
+
+These instructions require minimal knowledge of the terminal. There are also [[alternative instructions for those using Git|Installation using Git]].
+
+# Download the code [[direct from GitHub|https://github.com/TiddlyWiki/TiddlyWiki5/archive/refs/pull/7915/head.zip]]
+# Open a terminal window in the root of the downloaded folder
+# Install the dependencies with the command: <<.copy-code-to-clipboard "npm install">>
+# Start the server with the command: <<.copy-code-to-clipboard "npm start">>
+# To use MWS, visit http://localhost:8080 in a browser on the same computer
+# When you have finished using MWS, stop the server with <kbd>ctrl-C</kbd>
+
+To update your copy of MWS with newer changes will require re-downloading the code, taking care not to lose any changes you might have made.

editions/multiwikidocs/tiddlers/Usage.tid

@@ -0,0 +1,12 @@
+title: Usage
+modified: 20241105133737778
+created: 20241105133737778
+
+Once MWS is successfully [[installed|Installation]], you can access it by visiting http://localhost:8080 in a browser on the same computer.
+
+By default, MWS is installed with full anonymous access enabled, meaning that anyone with access to the server has full access to read and modify anything. However, also by default, the server is only accessible to browsers on the same machine.
+
+If you intend to put an MWS installation on a public network like the Internet, the server will need to be secured with the following steps:
+
+* Create and login with a new administrator account
+* Disable anonymouse access

editions/multiwikidocs/tiddlers/images/MWS Banner.png.meta

@@ -0,0 +1,4 @@
+title: MWS Banner.png
+type: image/png
+tags: picture
+alt-text: Banner for the new Multi Wiki Server plugin for TiddlyWiki

editions/multiwikidocs/tiddlers/system/macros.tid

@@ -0,0 +1,11 @@
+code-body: yes
+tags: $:/tags/Macro
+title: $:/editions/multiwikidocs/doc-macros
+type: text/vnd.tiddlywiki
+
+\procedure .copy-code-to-clipboard(text)
+<div>
+<$transclude $variable="copy-to-clipboard-above-right" src=<<text>>/>
+<$codeblock code=<<text>>/>
+</div>
+\end .copy-code-to-clipboard