This page is for instructions and groupthink on moving the lojban.org site from a bunch of static (ish) html pages to the TikiWiki. If you're not helping with that effort, you probably don't want to be here.
Goals
Just for the record, here's why I'm doing this. This is an ordered list.
- Make life easier for myself. That is, to make it easier for me to edit and maintain the site, and to make it possible for other people to do so at my direction (which also, obviously, makes my life easier).
- Make a better site for the users. This is sort of a side effect of point 1 (the easier it is to make a good site, the more likely it is to happen), but the more Tiki features (such as expandable menus) we can leverage to make getting around the site easier for users, the better.
OK, so it's not much of a list.
I want to point out, though, that as a side effect of point 2, reducing user confusion is a Good Thing. I'm actually using the tables on this page to automatically create a giant redirection list, so the old site URLs should continue to work as normal.
Stage Two Instructions
Now that we have actually done the site move, the instructions below don't work so well. In particular, most of the links below will fail. To make them work again, go to www.lojban.org/static/; this will give you the old site. In addition, www.lojban.org/remaining/ has all the things that still need to be moved, most of which aren't HTML and most of which aren't on the list below, so you'll need to add them. In particular, http://www.lojban.org/remaining/file_list.txt has a complete list of all the stuff that's in there, and hence still needs to be moved.
Please ignore the stuff under "texts/translations" for the time being. Those are all automated, so there needs to be some code hacking there.
Instructions
I strongly suggest that you have your browser set up to launch a Real Editor for text entry fields. I use a text-only browser (w3m) for this purpose. Mozilla-based browsers, such as Mozilla and Firefox, have the ability to interface with any editor using the mozex or ViewSourceWith extension (must be downloaded separately). The former is older, and may not work on Windows.
- Pick an unclaimed page from the list below.
- Decide on a name for it. The name should be a full English phrase (unless it's a translation, of course) with correct capitalization and spacing. This is going to be the page title, so it should look good in a browser title bar. Indicate that name in the list with a Wiki link to the name.
- Copy the URL given.
- Go to the link you've just created.
- Select the language
- Set the category to Official and select "categorize this object"
- Paste the URL into the Import HTML box.
- Check "Try to convert HTML to wiki"
- Click "Import"
- Clean up the results
- Save the page
- Lock the page
The "clean up the results" step deserves a tad more explanation. The following things should be done when cleaning up:
- Remove all HTML.
- Remove all the menu and flags stuff at the top.
- Replace all links to other files that appear in the list below with Wiki links to their Wiki page names.
- If a file has not had a Wiki page name assigned, assign one and enter it here, but do not put anything in the link you create. This (a named page with nothing in it) indicates that a name has been assigned, but no-one has imported the page yet.
- Put all items in a list on consecutive lines.
- Trim headers (that's lines that start with . What I mean by this is, if a page's title is "Foo", there's no need to have "!Foo" at the top, which is what the import will usually generate. In some cases (such as the minutes) the first header is too long to make a reasonable page name, and thus might as well be preserved, but in most cases the first header should be deleted. This implies removing one ! from all the other headers.
- If there is a link to something in the lojban.org web space that is not an HTML file, put it in the non-HTML files table at the bottom of this page.
The pages below the don't end in ".en" are those tranlations that seemed to have a non-trivial amount done on them on the old site. The process for doing translations is just the same, except that after you're done entering the translated page, go to the button at the bottom that says "translation". Select the language of the page, hit save. Then go to the page this is a translation for, make sure a language is selected (select one and hit save if not). Then enter the translation you just created in "Set of translations", and click "go" or "add to set" (depending on if there are already other translations).
The Files List
Free-Form Redirection Table
Gets turned into pretty arbitrary redirects. Please be careful.
Table Of Non-HTML Files
Most (but perhaps not all) of these files should be turned into
attachments on a wiki page and linked here using the {file
...} format links. Hmm. Maybe not. Simpler to leave them where they are. Saves a lot of wierd probelms. Should probably put the RefGram stuff back too, in fact.