-
Notifications
You must be signed in to change notification settings - Fork 8
Editing this wiki locally
Marc Dutoo edited this page Mar 27, 2014
·
9 revisions
To edit this wiki locally (and upload files such as images...), merely use git :
git clone git@github.com:easysoa/EasySOA.wiki
# then edit / add / remove files, commit and push
In order to more easily work on this wiki with the editor of your choice, you can install locally the engine behind Github's wiki system.
- Ruby
- Install build prerequisites libxml2-dev and libxslt1-dev (these are the package names on Ubuntu 12.04).
- Install Gollum and its Markdown parser:
sudo gem install gollum redcarpet
- Clone the EasySOA wiki (which is itself a Git repository):
git clone git@github.com:easysoa/EasySOA.wiki.git
- From the folder where you cloned the wiki, run:
gollum
- Go to http://localhost:4567 to browse your local version to the wiki.
- Edit the .md files, commit them, preview them and push!
- Q: The pages are not updated after I edit them.
- A: The engine use the HEAD commit from your repository. Did you commit your changes? (a fast way to do so is to use
git commit -am "edit"
)
- A: The engine use the HEAD commit from your repository. Did you commit your changes? (a fast way to do so is to use
- Q: Nested lists don't appear as expected on the local version.
- A: Try to add "li ul { margin-left: 20px !important; }" to
/usr/lib/ruby/gems/1.8/gems/gollum-2.0.0/lib/gollum/frontend/public/gollum/css/template.css
.
- A: Try to add "li ul { margin-left: 20px !important; }" to