- Introduction
- Posting
- Changing your CSS
- Changing the links
- Deleting a post
- Renaming a post
- ATOM/RSS
- Changing your weblog's title
- Checkout your repos
- Ratings
- Making suggestions
Introduction
These are instructions for how to control your weblog hosted in The Freaks Unidos wiki.
You might also want to take a look at the wiki syntax that your posts should use.
Posting
The filename for your post should roughly correspond to the title you want to use but with the following restrictions:
- Use all lowercase characters in your post's filename.
- Avoid weird characters. There is a problem with URLs having non-ascii characters (the URL doesn't specify the encoding, so its impossible to tell... and HTTP doesn't include provisions to specify the encoding used to transmit the URI) so avoid them... to stay on the safe side, avoid anything other than letters, numbers and dashes.
- While you could use spaces (and some do), we advise you not to. Just use dashes. A URL with dashes looks better than one with spaces (which are displayed as %20).
- Use something descriptive as your posts name. It's a file name, though, so don't use something extremely long. Note that you will be able to set the real text that svnwiki displays as the post's title (keep reading).
For example, if your post's title is "New Post", use http://wiki.freaks-unidos.net/weblogs/USER/new-post
The file's contents should correspond to your post in wiki format. Make sure it is encoded in utf-8.
Give the wiki engine a some seconds to update your weblog. It usually takes around 20 seconds, but that could vary greatly depending on the number of articles that the wiki engine has to regenerate as the result of your post (eg. it shares a lot of tags with a lot of articles).
By default, your post's title will be its filename. You can set it to something else. In that case, we still recommend that your post's filename matches its title as well as possible (given the above restrictions) to make it easy for people to make links to your post (because, in links, they need to enter the filename, not the post's title). Right now this is impossible through the web interface; you'll have to use svn. Set the svnwiki:title property in your post to the value you want to use. For example:
svn ps svnwiki:title 'This is MY post / otra prueba!' my-post
If you want to use characters not in us-ascii, make sure to use utf-8.
Changing your CSS
Edit the svnwiki-css file in your weblog's directory.
To do it through the web interface, visit:
Actually, if you want to make a lot of changes and test them, waiting for svnwiki to regenerate everything and upload it might be slow. You're probably better off:
- Loading your weblog on your browser.
- Saving it (make sure it saves every file it depends on, specially the CSS).
- Edit the CSS locally and test your changes reloading your saved copy.
- Once you're ready, overwrite the svnwiki-css file with yours.
Changing the links
To change the list of links at your right (which in a newly created weblog begins with the text “Some links could go here” and which corresponds to a template's %i sequence), edit your files/menu file.
To do it through the web interface, visit:
Deleting a post
To delete a post just delete its associated file.
Right now this is impossible through the web interface; you'll have to use svn.
Renaming a post
To rename a post just change the name of its associated file.
Right now this is impossible through the web interface; you'll have to use svn.
ATOM/RSS
An RSS feed for your weblog is available here:
Changing your weblog's title
You need to set the svnwiki:title property on your weblog's index file.
Right now this is impossible through the web interface; you'll have to use svn.
Through svn you would:
svn propset svnwiki:title 'my happy hippie hippo weblog' index svn commit
Note that the value should be in utf-8.
Checkout your repos
Make sure you have a valid user account for connecting to the repos (contact Azul if you don't) and do:
svn checkout https://freaks-unidos.net/azul-home/doc/wiki/weblogs/USER
Ratings
If you want to enable your readers to rate your articles up or down (vote up/down), add the word rating to the svnwiki:handler property of your weblog's directory and set the rating:ignore to yes in index, xsvnwiki-discuss, images, files and any other files or directories that shouldn't be rated.
You can do this running the following commands in your weblog's directory:
svn ps svnwiki:handler "$(svn pg svnwiki:handler .) rating" . svn ps rating:ignore 'yes' index xsvnwiki-discuss images files
Commit your changes. As your weblog starts to be regenerated, the cool links will begin to show up.
Making suggestions
See ../svnwiki-weblog-suggestions. Follow the instructions there.
Last update: 2007-07-28 (Rev 12523)