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 ++++++++++++++++++++++++++++++++++++++++++++++++++- README.md | 68 +-------------------------------------------------- notYetAnotherWiki.lua | 2 +- 3 files changed, 69 insertions(+), 69 deletions(-) mode change 120000 => 100644 README mode change 100644 => 120000 README.md 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. diff --git a/README.md b/README.md deleted file mode 100644 index 334cea4..0000000 --- a/README.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -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. diff --git a/README.md b/README.md new file mode 120000 index 0000000..100b938 --- /dev/null +++ b/README.md @@ -0,0 +1 @@ +README \ No newline at end of file diff --git a/notYetAnotherWiki.lua b/notYetAnotherWiki.lua index 977a117..e7f0873 100755 --- a/notYetAnotherWiki.lua +++ b/notYetAnotherWiki.lua @@ -117,7 +117,7 @@ end local directory = arg[1] if nil == directory then directory = '.' end -for l in io.popen('find ' .. directory .. ' -name "*.md" -type f -printf "%P\n"'):lines() do +for l in io.popen('find ' .. directory .. ' -name "*.md" -type f,l -printf "%P\n"'):lines() do local dir = '' local files, subs = {}, {} local c, parent = 1, '' -- cgit v1.1