From 1ed6c0b61ac80c2f1ba7b6e79eb75c4257cc4de9 Mon Sep 17 00:00:00 2001 From: dvs1 Date: Sun, 22 Dec 2024 03:25:18 +1000 Subject: Try it the other way, cgit is fussy about it's README. --- README | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 67 insertions(+), 1 deletion(-) mode change 120000 => 100644 README (limited to 'README') diff --git a/README b/README deleted file mode 120000 index 1cfe87d..0000000 --- a/README +++ /dev/null @@ -1 +0,0 @@ -/home/dvs1/AboutMe/notYetAnotherWiki/README.md \ No newline at end of file diff --git a/README b/README new file mode 100644 index 0000000..334cea4 --- /dev/null +++ b/README @@ -0,0 +1,67 @@ +--- +favicon: cartdave_favicon.png +pagetitle: "notYetAnotherWiki is not another wiki, at least not yet. It'll be much more than that, eventually." +author: onefang +feedatom: https://sledjhamr.org/cgit/notYetAnotherWiki/atom +history: https://sledjhamr.org/cgit/notYetAnotherWiki/log/index.md +sourcecode: https://sledjhamr.org/cgit/notYetAnotherWiki/ +--- + +notYetAnotherWiki is not another wiki, at least not yet. It'll be much +more than that, eventually. + +So to start with it's not a wiki. It's currently a way to create a web +site with CommonMark wiki markup, using git to update the content. + +So it's not a wiki, yet. + +Next comes accounts and online editing of content with the web pages. +It'll then barely be a wiki. + +The missing bit is talk pages, which requires some sort of archiving chat +system built into the thing. Now it's Yet Another Wiki. + +Finally comes the magic, so it's "not Yet Another Wiki", it's much more +than that. + +A web forum is basically a web based chat system with archiving. We got +that now, we can just say it's a web forum as well. Just leave off the +wiki page bit. + +Only difference between an instant messaging system and a web forum is +how fast it runs. So just make this fast, then we can call it an instant +messaging system. + +Put email behind a web forum, you got a mailing list with a web archive. + +An issue tracker is basically a wiki type page with the forum style +messages, and often an email control system. Only that last bit needs to +be added. + +A lot of projects will put together all of these things to support their +users. Different systems, different accounts, same info. Too much "Oh, +that's in the forum somewhere" on the mailing list or whatever. + +notYetAnotherWiki puts it all together as a single system, with multiple +ways of using it depending on what the users want, and ways of organising +the useful info that makes it's way into the system one way or another. + +Someone comes into your chat system, asking for help, within minutes +people are helping out and come up with a working solution. After a few +other people turn up with the same problem, the existing conversations +are moved to the decumentation section, where the original participants +and others can polish it into proper documentation about solving what has +suddenly become a common problem. Every one knows where to find it, on +the one system. They can chat about it, on the one system. + +## What does it do already? + +Currently it'll scan the current directory and subdirectories rooking for +.md files in CommonMark syntax. This should cover some MarkDown +variations. Then it produces .HTML files converted from these .md files, +and links them all together into a web site. + +git is used to store the .md files, and provides edit history. Added on +the footer is links to cgit, which is used to store the files in git on +your server. This provides acces to the source code, history, and ATOM +feed for the site. -- cgit v1.1