Bootstrapping Methods

[Jon Richter]

Thanks for making this beautiful MarkDown wiki become reality.

There are no real competitors out there, despite some funny experiments.

As I am trying to find my way around django-wiki,

I found some points worth mentionning, esp. regarding the docs:

__prequisites (on Fedora / CentOS / RHEL), assuming pip and virtualenv(wrapper - for those who like) are well configured and just work

- sudo yum install -y libjpeg-devel libpng12-devel

__Initial setup

- git clone https://github.com/django-wiki/django-wiki.git

- cd django-wiki/

- virtualenv .

- . bin/activate

- pip install -r requirements.txt

* to successfully run the testproject (`python manage.py runserver`) I had to migrate its DB with `python manage.py migrate` to get the notifications working (again?).

* to create my new project, still from the django-wiki/ root, I had to run `python ./lib/python2.7/site-packages/django/bin/django-admin.py startproject MarkDownWiki`

- cd MarkDownWiki

- nano MarkDownWiki/settings.py < fill with breadcrumbs from the testproject plus raw documentation

- python manage.py syncdb

- python manage.py migrate

- python manage.py runserver

I wonder if there is a way to compensate the strange django-admin.py path/usage within the virtualenv.

As of http://www.jeffknupp.com/blog/2012/02/09/starting-a-django-project-the-right-way/, `django-admin.py ...` just worked out of the box

__docs improvements

I'd like to see more headlines or more detailed pages for everything that happens in between the #Install and ##Configure headlines in https://github.com/django-wiki/django-wiki/tree/master/testproject.

I am lucky I have seen Django already; others might get crazy without clearer explanations.

As it's running so well in dev (the testproject) I should now try to create my own site (using SQLite for the moment) and if successful, deploy it somewhere online, to see how it performs.

Thanks for this nice work; as master ran quite flawlessly, is a new, feature-frozen release expected soon?

Ciao,

Jon

[Jon Richter]

Additionally, PyPI still indicates 0.0.23, which conforms with the GitHub releases, but the docs are already talking about 0.0.24 and 0.1, which is called RC1 in other places, I suppose.

http://django-wiki.readthedocs.org/en/latest/release_notes.html#django-wiki-0-1

https://github.com/django-wiki/django-wiki/blob/master/TODO.md

The django-wiki 0.1 section also has a line that reads django-wiki==0.3 - which I believe is an error.

---

+ PLUS

The Help and Links accordions next to the _edit box don't mention, that creating links with Wiki Syntax à la `[[Sitename or another]]` work's, too.

[Jon Richter]

Dear Django Wiki crew,

I am happy that my site is running now : https://wiki.14mmm.org

Also, due to the django-wiki-project-template using the PyPi based installation, my codebase is more than half a year old. I am sure, if no new release is due soon, I will have to walk the hard way and switch to a GitHub repo based deployment, hopefully able to migrate the database.

Because now, the MarkDown driver cannot even render external links. I am sure this has been changed in the last months.

Some further notes I took during installation, still for CentOS and already within the virtual environment (". bin/activate"), which I would now put directly into the "wiki" folder.

pip install mysql-python (as the MySQL database driver in my case)

Additionally, as the django-wiki-project-template emphasizes on using the base.py naming scheme for Django configurations [1], it only worked when I changed the settings path to "settings.base".

The docs were also missing instructions on how to set up the static files, i.e. merging the static/wiki and static/admin paths to have a full-functioning Django install afterwards (for managing groups, etc.).

Then, next to a somewhat complicated uWSGI configuration, an upstart script and nginx config example can be provided once I have my setup on an actual codebase.

Currently I just git'ed the PyPi wiki folder [2] and include my changes there, knowing I should have switched to the current master.

It would be nice to stay in touch,

ciao,

Jon

[1] https://github.com/django-wiki/django-wiki-project-template#setting-structure

[2] https://github.com/14mmm/django-wiki

[Akshay Mukadam]

Did you just copied the wiki folder and applied the url specified in the docs