Textpattern CMS support forum
You are not logged in. Register | Login | Help
- Topics: Active | Unanswered
[wiki] TextBook under Subversion: Possible? Worthwhile?
Anyone who understands subversion a little better than I want to comment on whether it’s possible or worthwhile for TextBook?
I seem to think it would be, if nothing else a good exercise, considering we are going to start a TxB skin and will need to updrade the wiki in the future, but I’m not savvy enough with subversion to know if it’s possible with mediawiki, or if mediawiki’s built-in history/diff abilities would conflict with doing so. Thoughts on this?
If there’s nothing standing in the way, what’s the first step?
Offline
Re: [wiki] TextBook under Subversion: Possible? Worthwhile?
Subversion is used for version/revision control, mostly for software, but it’s used at the place I work for documentation as well. What exactly would you be storing though? A single text file, multiple text files?
Honestly, I think a Wiki is better for collaborative documentation than SvN would be.
Offline
Re: [wiki] TextBook under Subversion: Possible? Worthwhile?
Not really meaning to replace the wiki, but rather using SVN as a means for easily upgrading the wiki in the future, much like anyone might do for upgrading their Textpattern sites. Maybe I’m thinking of it wrong here?
Offline
Re: [wiki] TextBook under Subversion: Possible? Worthwhile?
Mediawiki is stored in CVS so we can’t pull updates straight from the repository. We would have to import changes into our own SVN repo and then roll it out from there. It could help with things like the skin but it wouldn’t really make upgrading it any easier.
Honestly the main issue I ran into when doing the upgrade was that the upgrade script just would not run from the command line on textdrive which was very weird. No errors nothing it would just dump me at the shell prompt again everytime, so I had to do the web upgrade which is kind of a pain because it’s basically setting the wiki up again from scratch.
Last edited by hakjoon (2005-11-20 19:53:47)
Shoving is the answer – pusher robot
Offline
Re: [wiki] TextBook under Subversion: Possible? Worthwhile?
Mediawiki is stored in CVS so we can’t pull updates straight from the repository. We would have to import changes into our own SVN repo and then roll it out from there.
Ah..that makes sense.
Cool. Thanks hakjoon. SVN is certainly not critical. Maybe what would be good then is to make some notes in the wiki somewhere about the upgrading process (and the irregularities you learned from doing so); probably in the Meta namespace would be the appropriate place.
Side: I’m still trying to understand the namespaces better. For example, I know that the Meta namespace is out of the public search area (and therefore good for project/admin discussions, notes, documentation, etc.), but I’m not clear about what page options are in the meta namespace (or if you have to create custom ones). Taking the example further to illustrate…the Special namespace has a built-in page called Userrights (and there’s others), and the resulting part of the URL looks like Special:Userrights. I can’t seem to find a reference anywhere in MediaWiki about what builtin pages are available by default for each namespace. Any clues on this?
Things off the top of my head that I think would be worthwhile to document for admin reference (and perhaps TxD use):
- Upgrading TextBook (the wiki) on the TxD server
- Implementing Clean URLs
- Implementing RSS
- Modifying the languages table (internationalization)
- etc.
EDIT: OK, found one in the Meta namespace (Meta:Projects), and according to the namespace page I linked to above, it’s probably the right one to be using for wiki admin docs …at least to get started with.
Offline
Re: [wiki] TextBook under Subversion: Possible? Worthwhile?
I pretty sure SVN can’t handle opendocument (or other) format as well as pure plain text (with human-readable revisions, modifications, and so on). So no semantic can’t be added to documents.
If I’m wrong on this, I would be happy to know, it would make my life so much easier….
Offline