changeset 384:93a2f7c86059

cm: Simplify README file, add link to official website.
author Ludovic Chabant <ludovic@chabant.com>
date Sun, 04 Oct 2015 08:15:21 -0700
parents c19b8cc11938
children 003316f77d3a
files README.md
diffstat 1 files changed, 11 insertions(+), 81 deletions(-) [+]
line wrap: on
line diff
--- a/README.md	Sun Oct 04 08:14:20 2015 -0700
+++ b/README.md	Sun Oct 04 08:15:21 2015 -0700
@@ -10,96 +10,26 @@
 Wikked is a wiki engine entirely managed with text files stored in a revision
 control system like Mercurial or Git.
 
-It's in early alpha, and will probably not work at all except on my machine. If
-you still want to try it, great! Please note that:
+The documentation is available on the [official website][1].
 
-* On Mercurial is supported at the moment. Git support is planned.
-* The command-line interface is temporary and incomplete.
-* Lots of incomplete or buggy stuff. Like I said it's alpha!
-* Please report any bug on [Github][gh].
+[1]: http://bolt80.com/wikked/
 
 
-## Installation
+## Quickstart
 
-Install Wikked the usual way:
+You need Python 3.4 or later. Then, you install Wikked the usual way:
 
     pip install wikked
 
-Or, if you're using `easy_install`:
-
-    easy_install wikked
-
-You can also install it from the source, which you can find on [BitBucket][bb]
-or [Github][gh].
-
-[bb]: https://bitbucket.org/ludovicchabant/wikked
-[gh]: https://github.com/ludovicchabant/Wikked
-
-
-## Setup
-
-Until Wikked is feature complete with its command-line utility, there's a few
-steps needed to setup a new wiki:
+Create a new wiki:
 
-1. Create a new Mercurial repository: `hg init mywiki`
-2. Go there: `cd mywiki`
-3. Create a `Main Page.md` text file, put some text in it.
-4. Run `wk reset` to initialize the wiki.
-5. Run `wk runserver` and navigate to `localhost:5000`.
-
-If you're using an existing repository instead in step 1, make sure that you add
-the `.wiki` folder to your `.hgignore`, and that's where Wikked will cache some
-stuff (which you don't want committed or showing up in `hg status`).
-
+    wk init mywiki
 
-## Wiki Configuration
-
-You can configure your wiki with a `.wikirc` file in the root of your website.
-
-Optionally, you can define a `.wiki/wikirc` file, and any settings in there will
-be merged with the `.wikirc`. The difference is that the one at the root is
-typically committed to source control, whereas the one in the `.wiki` folder
-will only be local to the current repository clone, so that makes it possible to
-have local overrides.
-
-The configuration is written in INI-style:
+Run it:
 
-    [section]
-    name = value
-    other = whatever
-
-    [other_section]
-    name = value
-
-
-### `wiki` Section
-
-All the following configuration settings should be in a `[wiki]` section:
-
-* `default_extension` (defaults to `md`): the default extension to use when
-  creating new pages.
-
-* `main_page` (defaults to `Main Page`): the name of the page to display by
-  default in the browser.
+    cd mywiki
+    wk runserver
 
-* `templates_dir` (defaults to `Templates`): the directory to search for first
-  when including pages only by name (as opposed to by fully qualified path).
-
-
-### `ignore` Section
-
-This section defines more files or folders for Wikked to ignore (_i.e._ files
-that are not pages, or folder that don't contain pages).
+Navigate to `http://localhost:5000`. If you see the default main page, every
+works fine! Otherwise, something went wrong.
 
-Each item in this section should be `name = pattern`, where `name` is irrelevant,
-and `pattern` is a glob-like pattern:
-
-    [ignore]
-    venv = venv
-    temp = *~
-    temp2 = *.swp
-
-This will ignore a `venv` folder or file at the root, or any file or folder
-anywhere that ends with `~` or `.swp`.
-
-