- Introduction
- Editing
- Errors and troubleshooting
- How can I get a list of all the files in my wiki that have no tags?
Introduction
This is the svnwiki FAQ.
Feel free to add new questions if you believe they are general enough to deserve inclussion.
Editing
How come I can't edit a certain file?
If, when you try to edit a file through the web interface and you only get the "Differences" and "Preview" buttons but not the "Save" button, this is very likely because the svnwiki:frozen property is set on the file. This property makes Svnwiki refuse to let users modify the files it's set on through the web interface, regardless of the identity they use.
However, if you get a Save button, but it requires authentication, then it's very likely because the svnwiki:authenticate property is set to yes on the file or on the directory. This property makes Svnwiki refuse to let unauthenticated users modify the files it's set on through the web interface.
You can permit anonymous discussion while restricting modification by setting svnwiki:authenticate to no in the xsvnwiki-discuss directory, or in the corresponding file.
How do I add tags to a file?
Enter the following sequence:
[[tags: ... ]]
Instead of ..., use all the tags you want, separated by spaces. Note that you can only use alphanumeric characters as the tags, other characters will be ignored.
How do I have a file show a table of contents at its beginning?
To include the table of contents of the current file, add the following sequence at its beginning:
[[toc:]]
This will be replaced with a list of all the sections (titles) of the current file.
Are files in a Svnwiki repository case sensitive?
Yes, they are. All wiki repositories should standarize on having all files in all-lowercase characters.
Files "Alejo" and "alejo" are differently treated. Svnwiki, however, handles local links intelligently. Suppose it comes across a link to file "Foo":
- If the linked-to file exists, nothing special is done with the link, it is left as is.
- Otherwise the link is made to an all-lowercase version of the file ("foo"). As a consequence, new files will usually be created in lowercase and, once created, the link will send visitors to it.
Note that, as a consequence, you could use a link such as Alejo to have it shown that way in the HTML page but it would take you to alejo unless Alejo indeed exists (and, if he doesn't, who wrote this?).
How do I edit a discussion with my favourite editor?
Editing the corresponding file in the "xsvnwiki-discuss" directory. Basically, a comment is structured in the following way:
SEPARATOR ... TEXT ... SIGNATURE
SEPARATOR = ---- (only necessary if there exists a previous comment). TEXT = any valid character defined in svnwiki-charset. SIGNATURE = -- '''USER''', DATE USER = your username, nickname, first name or full name. DATE = the output of the date command.
If you use VIM as your text editor, you might find it useful to define a command to insert your signature at the end of your comments. To do this you must add the following code to your ~/.vimrc file:
com -nargs=0 Sign call SignatureInsert()
function SignatureInsert()
read !echo -- \'\'\'$USER\'\'\', $(date)
endfunctionNow you can sign your comments when you edit them with VIM with the Sign command, eg. :Sign.
Errors and troubleshooting
I get error: Can't open file '/TMP-PATH/.svn/lock': Permission denied
If you get an error in your log saying
svn: Can't open file '/TMP-PATH/.svn/lock': Permission denied ,
it's probably because you might have checked out TMP-PATH yourself (as a user other than the one your CGI applications run as). Just erase it and let svnwiki check out a copy itself:
rm -R /TMP-PATH
How can I get a list of all the files in my wiki that have no tags?
You can use the following command to generate it:
sqlite DATA-PATH/deps.db "SELECT creationdates.page FROM creationdates LEFT JOIN tags ON creationdates.page = tags.page WHERE tag is null;"
Last update: 2007-07-30 (Rev 12590)