This repository has been archived by the owner. It is now read-only.
Browse files

Add default wiki content.

  • Loading branch information...
felixplesoianu committed May 25, 2017
1 parent e9dee48 commit dae7b9410a54f2a96afc5ed5f17de32c2e290f69
@@ -0,0 +1 @@
<<include FelixPlesoianu>>
@@ -0,0 +1 @@
<<include WikiWords>>
@@ -0,0 +1,16 @@
: "nothing lasts, nothing is finished, and nothing is perfect" --
== What WabiSabi is
; **clean** : Any feature that involves complex logic is right out.
; **concise** : It is the author's opinion that sprawling code is as bad as obfuscated code.
; **useful** : That said, minimalism for the sake of it doesn't help anyone. There should be a balance.
== What WabiSabi isn't
; **complete** : Other WikiEngines include everything and the kitchen sink, not to mention an atoll or two plus a coral reef. That makes them harder to understand and use for anyone who //doesn't// need the extra features.
; **definitive** : These goals are likely to change over time and there's nothing wrong with that.
== See also
@@ -0,0 +1,5 @@
Each wiki needs to keep its data somewhere. There are several techniques for doing that, but most wikis use one of these:
* FlatFileStorage: Used by UseMod, OddMuse, PmWiki, DokuWiki and WabiSabi.
* KeyValueStore: Employed by the original WikiWikiWeb in the form of GNU DBM.
* RelationalDatabase: The most sofisticated solution, adopted by MediaWiki and other, less known WikiEngines.
@@ -0,0 +1 @@
DokuWiki is a large-ish engine with FlatFileStorage, an user-friendly interface and very good media support. While the internals are quite complex, ready-made themes and plugins are easy to install and manage.
@@ -0,0 +1,8 @@
* (19.5K)
* (19K) -- previous version
* (20K) -- legacy version
If you are asking what license this software is released under, you are asking the wrong question.
The archive may lag behind the online version at times. Be patient. Better yet, contact me. :)
Please keep in mind that WabiSabi was created out of academic curiosity. It may or may not be suitable for a production website. Especially as it's little used, so it may well have bugs and security holes. That said, I //am// trying to make it useful, so feel free to leave QuestionsAndFeedback. Also check out the RoadMap.
@@ -0,0 +1,25 @@
;**Modern markup**: Mostly a subset of WikiCreole, except with a completely different LinkSyntax.
;**Modern HTML**: Generated pages normally validate as HTML5 (though it's possible to break that), and CSS is supported. We're not in 1995 anymore.
;**UTF-8 support**: While page names are restricted to ASCII characters, page contents are handled as UTF-8, permitting a wide range of characters.
;**Page transclusion**: Can be used as a poor man's redirect, plus other things.
;**Flat-file storage**: Pages are saved as ordinary text files on disk, making them easy to backup, inspect or change from outside WabiSabi.
;**Page backups**: The previous two versions of any page are saved. A future release will probably offer access to them.
;**Captcha**: The simplest possible system, based on a fixed password. Before you ask, yes, this is effective, and also allows for a non-public wiki simply by hiding the password.
;**Recent changes**: On the other hand, it should be easy to watch when pages are changed, in order to catch vandalism quickly.
;**Universal Edit Button**: See
;**Plugin support**: Allows creating extra wiki actions and markup plugins, and replacing or modifying the built-in templates, without any changes to the core file.
== Plugins
;**Wanted pages**: Finds and displays all links to non-existent pages on the wiki.
;**RSS newsfeed**: Renders the recent changes as a newsfeed in RSS format, making it easy to monitor automatically.
@@ -0,0 +1,5 @@
<<title Felix Pleșoianu>>
I am the author of WabiSabi, an administrator at and occasional editor at and Wikipedia. My personal website at also includes a wiki.
@@ -0,0 +1,7 @@
FlatFileStorage is the practice of saving a program's data in plain text files, which can be read and modified with a simple text editor. While this is [ in the Unix tradition], nowadays there is a widespread myth that flat files are somehow slow. See for example [ Flat File Advantages] for a rebuttal, but the gist of it is: a RelationalDatabase still has to read your data off the disk, and //then// it has to perform all kinds of complex operations on top of that.
That said, there are several ways to use flat files in wiki engines.
* PmWiki saves pages in a complex format, with a change history recorded per-paragraph and some metadata on top of that.
* OddMuse saved pages are in a MIME-like format, with a little metadata on top followed by the latest version of the page in plain, human-readable text.
* DokuWiki saves each page as the user typed it, and the metadata, history etc. go elsewhere. This is also the approach taken by WabiSabi.
@@ -0,0 +1 @@
@@ -0,0 +1,5 @@
* <<home>>
* DownloadPage
* QuestionsAndFeedback
* WikiLicense
* AboutTheAuthor
@@ -0,0 +1 @@
Nowadays, the most prominent WikiEngines use double square brackets to delimit both internal and external links. WabiSabi, on the other hand, sticks with the traditional WikiWords. The only time when it does follow the WikiCreole linking convention (mostly...) is when inlining images.
@@ -0,0 +1,5 @@
MediaWiki is one of the largest WikiEngines, originally created for [ Wikipedia] and used by many other wikis. It sits at the opposite end of the complexity spectrum for WabiSabi, which only borrows a subset of the MediaWiki table syntax (and the definition list syntax, in common with most other engines).
MediaWiki is one of the few major WikiEngines using a RelationalDatabase for storage, which it justifies by being optimized for very large wikis.
@@ -0,0 +1,3 @@
A descendant of UseMod, itself one of the oldest WikiEngines, OddMuse is a one-file lightweight engine written in Perl. Notable features are FlatFileStorage and built-in blogging support.
Installing and managing OddMuse requires some knowledge of Perl. The engine is highly extensible, but looks are customized almost exclusively via CSS, as changing the HTML requires writing an extension.
@@ -0,0 +1,5 @@
<<title PHP Wiki>>
[ PHP Wiki] is a true WikiWikiWeb clone (in that it tries to imitate the original wiki as much as possible), and one of the earliest WikiEngines written in PHP. Unfortunately, it is also very large for what it offers; the configuration file alone is larger than the WabiSabi core.
PhpWiki's main feature appears to be support for a wide variety of databases..
@@ -0,0 +1 @@
PmWiki is a lightweight engine with FlatFileStorage and many unique ways to organize content. On the downside, setting up and administering PmWiki requires some knowledge of PHP. On the upside, the engine is very easy to extend and customize.
@@ -0,0 +1,19 @@
Well here's a feedback: This Wikisoftware just rocks! :D Thanks!
Believe it or not, I didn't write that. :P -- FelixPlesoianu
I really like the simplicity of WabiSabi and am experimenting with it now, for possible use as a website. Question: what's the plan for development, updates, etc.? I don't want to go down a dead-end street. :) --Randal
I'm afraid WabiSabi was a one-off experiment, Randal. I don't have any plans for further development. But I'd be happy to talk about it. -- FelixPlesoianu
Sorry to hear there are no plans for development, Felix. But I understand the idea of the experiment. -- Randal
I have a WikiWord that isn't being interpreted correctly by the software: NT-Ga4_12-20 . The last zero isn't being accepted as a part of the link. What's going on here?
A: Looks like a bug! I'll try to look one of these days (as of 2011-11-11). No promises though, life's busy. Drop me an e-mail, and I'll let you know.
In the main file, only 1-9 were defined as possible digits for a WikiWord. I know almost nothing about code and all that, but I changed it to 0-9 and it worked. :) BTW, didn't see an email for you anywhere, so I just popped in here. -- Randal
My e-mail is at the top of the file you just changed. Good catch, by the way, I'll publish a fixed version soon.
Hi, Felix, here's an application for WabiSabi that would rock the boat: A WordPress plug-in. The ones I see are either commercial and very limited, or not desirable for some reason.
@@ -0,0 +1,5 @@
Times in RecentChanges are UTC.
@@ -0,0 +1 @@
Mostly due to the ubiquity of MySQL, a RelationalDatabase is often the default choice of DataStore for Web applications. Of the major WikiEngines, though, only MediaWiki and PhpWiki use one.
@@ -0,0 +1,8 @@
I've been asked about my future plans concerning WabiSabi. Well, it was a one-off experiment which I didn't expect to keep updating. That said, there are some features I'd like to add sooner or later:
* easy restore from backup, to make spamming even less worthwhile;
* backlinks, for quick-and-dirty page categories;
* a page trail feature like the one in PmWiki;
* more plugin hooks, to make it truly extensible.
I'd be happy to take suggestions and generally talk development. My e-mail address is in the source code, and you can find me on various social networks.
@@ -0,0 +1,3 @@
UseMod is a WikiEngine written in Perl and using FlatFileStorage instead of a database. It is the precursor of OddMuse.
UseMod powers [ Meatball Wiki], a meeting place for people interested in the social aspects of wikis, and online communities in general.
@@ -0,0 +1,22 @@
WabiSabi is a fast experimental Wiki engine in 275 lines of PHP. The FeatureSet places it in the same ballpark as the original WikiWikiWeb, only with a modern bent. The name comes from a Japanese aesthetic that is reflected in the project's CurrentGoals.
This website is also about WikiEngines and WikiTechnology in general. It is an open wiki, as it should be. If in doubt, see WhenToContribute. The WikiSandbox will give you an idea of the supported syntax.
== News
;2015-03-08: We have new users at -- a German computer club, it would seem. Thanks for the plug, guys!
;2014-02-15: Wabisabi Wiki has moved! Please update your bookmarks.
;2013-05-23: [ Abby Stabby], a personal wiki, claims to run a modified WabiSabi, though no details or download are provided. (Download link to all but content is here: [ AbbyStabbyCode] and you'll see it is just that: WabiSabi plus a few modifications -- John who did the mods and owns
;2012-06-29: Fixed a bug whereas markup plugins wouldn't work in included pages; more flexible HTML; customizable GoToBar.
;2012-06-26: New version with many improvements: a GoToBar, date format option, Wanted Pages is now a plugin, reading and Recent Changes are faster. Also cleaned up the default set of pages.
;2012-03-28: Just found [ WabiSabi960], a neat mod with intriguing enhancements by a Russian web developer.
;2011-11-12: A new release fixes a stupid bug whereas the regular expression for WikiWords didn't accept the digit 0 (zero). Thank you, [ Randal]! This version also includes the title search plugin I developed and never released for some reason. (Ed: or not. Oops.)
;2011-11-07: [ BiblePost], a wiki for biblical studies, uses WabiSabi.
;2011-09-11: There is now a [ WabiSabi Wiki plugin for CakePHP] (site in Spanish).
;2010-09-18: Discovered [ yet another user of WabiSabi], this time a personal website (in Czech, I think).
;2010-06-20: Fixed a bug where the renderer would reject some uncommon yet valid URLs.
;2010-05-03: New features: more template variables, better page name checking, save now fails if page is unchanged.
;2010-02-04: Just discovered that the [ RetroForth Wiki] has been migrated to WabiSabi. Nice!
;2010-01-23: Added an RSS feed plugin (enabled by default).
;2010-01-22: Latest version brings a timezone setting to satisfy PHP 5.3, and two new template variables that can be set by plugins at load time.
;2009-11-14: Aaand... we have users! The [ Plume Team at the École Normale Supérieure de Lyon] have customized WabiSabi for their own needs. (I must be doing something right. -- FelixPlesoianu)
@@ -0,0 +1,13 @@
: "It is easier to ask forgiveness than to ask for permission" -- [ Grace Hopper]
This wiki is about wiki engines and wiki technology in general and the WabiSabi engine in particular.
Do contribute if:
* You honestly think you can improve the wiki.
* You can take responsibility for your own actions.
* You have a sense of humor.
Do abstain if:
* You're a rules lawyer.
* You think you're clever.
* You think you're special.
@@ -0,0 +1,6 @@
[ Wiki Creole] is an attempt to standardize page markup across WikiEngines. While an undoubtedly good thing, it is quite laborious to implement fully. Still, WabiSabi tries to follow the WikiCreole guidelines as much as possible within the project's CurrentGoals.
Major exceptions are:
; LinkSyntax is almost completely different. : Rationale: FreeLinks are an open can of worms, both for the programmer and the wiki user.
; Tables are based on a subset of the MediaWiki syntax. : Rationale: the syntax proposed by WikiCreole is different from that in any wiki engine, and more difficult to implement in the first place.
; Multi-level lists are not supported. : Rationale: they would double the size of the existing rendering engine for a minor gain.
@@ -0,0 +1 @@
<<include WikiEngines>>
@@ -0,0 +1,23 @@
There are hundreds of WikiEngines out there, and WabiSabi draws inspiration from quite a few of them.
== Similar engines
* [ Pawfaliki] should be the closest other engine out there, but isn't. Pawfaliki is almost 5 times as large as WabiSabi and skimps on markup in favor of various advanced features.
* [ Pwyky] is similar to Pawfaliki in size and features, except it's written in Python.
* WikiWikiWeb was the original wiki, and though it's written in Perl and with a different focus than WabiSabi, it is closer in spirit than the others.
== Major influences
* DokuWiki
* PmWiki
* OddMuse
== Others
* PhpWiki
* MediaWiki
== See also
@@ -0,0 +1,4 @@
The page content of [ WabiSabi Wiki] (as opposed to the source code) is under a
{{}} [ Creative Commons Attribution-Share Alike 3.0 Unported License].
By editing this wiki you are placing your contributions under the same license. Please make sure you have the rights to do so.
@@ -0,0 +1,56 @@
WabiSabi supports a limited, but hopefully useful set of markup patterns.
== Block-level markup
=== Headings
==== Over multiple levels
Normal paragraphs.
* lists
* and lists
# and numbered lists
## but no multiple levels
{{{Preformatted text
(no wiki markup recognized inside).}}}
|+like in
Horizontal lines.
: Block quotes,
;and finally:definition lists.
== inline markup ==
WikiWords, [ labeled external links], bare external links: and even pictures:
Explicit\\linebreaks, **bold** and //italic//, plus
,,subscript,, and ^^superscript^^.
Last but not least, you can have {{{'(inline code fragments)}}}.
=== Markup plug-ins
<////<include (page name)>> includes another page (duh!)
<////<title (page title)>> sets the displayed page title, presumably to something other than the page name.
linebreak by double backslash:\\
bottom of sandbox
@@ -0,0 +1,10 @@
While the original wiki's main selling point was technological in nature ("the simplest online database that can possibly work"), wikis have become famous mostly as a social phenomenon. Which they are, but as a result the technology side doesn't see much discussion, and that's too bad.
WabiSabi started as an attempt to see just how little one can get away with, both in terms of features and of code size. Turns out, a lot can be done with very little. For example, conventional wisdom holds that stateless wiki parsers can only implement a simplistic syntax. WabiSabi proves the contrary, with a 70-line stateless parser that offers most of the syntax from much larger wikis, and is extensible on top of that.
Many people on the original wiki discussed wiki technology -- the most obvious were new features that "obviously need to be added"; but some people found it more interesting to simplify the software and see what features that could be left out.
(For example,
[ the shortest wiki contest]
However, such [ wiki-on-wiki meta-discussion] is off-topic on the original wiki;
which led to such discussion being deleted and lost forever :-( or pushed to some other wiki -- such as the WabiSabi website (not to be confused with the WabiSabi WikiEngine ).
@@ -0,0 +1,3 @@
While WabiSabi is not a WikiWikiWeb clone, its FeatureSet places the two quite close. Each of them can do things the other can't. E.g. the original wiki has search, backlinks (apparently implemented via search), and "similar pages", but no preview function or page transclusion as far as I can tell. WikiWikiWeb uses a DBM database, WabiSabi uses flat files. Overall, I think the differences balance out.
@@ -0,0 +1 @@
<<include WikiWords>>
@@ -0,0 +1,8 @@
WikiWords (also known as CamelCase in programmer circles): Compound terms obtained by running together at least two capitalized words. WabiSabi uses them to designate internal links, much like WikiWikiWeb and a few other engines. Contrast with the far more common FreeLinks.
I must say I wasn't very fond of WikiWords at first, but they turned out to be trivially implemented, and they make it easy to choose page names. -- FelixPlesoianu
== See also

0 comments on commit dae7b94

Please sign in to comment.