Merge commit 'upstream/master'

[git.ikiwiki.info.git] / doc / index / discussion.mdwn

diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn
index 1ece57a9f1531ad540b4ff93a7c68181d1718f78..d52cb0a2dc41a3a7742f27e1955972d842b3b6d4 100644 (file)
--- a/doc/index/discussion.mdwn
+++ b/doc/index/discussion.mdwn
@@ -5,7 +5,7 @@ Do so here..
 Note that for more formal bug reports or todo items, you can also edit the
 [[bugs]] and [[todo]] pages.
 
 Note that for more formal bug reports or todo items, you can also edit the
 [[bugs]] and [[todo]] pages.
 

-[[toc ]]
+[[!toc ]]

 
 # Installation/Setup questions
 
 
 # Installation/Setup questions
 


@@ -58,20 +58,7 @@ I'm kind of at a loss how to track this down or work around it.  Any suggestions
 >Ubuntu Hardy Heron has a debian package now, but that does not work either.
 > --Dirk 22Apr2008
 
 >Ubuntu Hardy Heron has a debian package now, but that does not work either.
 > --Dirk 22Apr2008
 

-----
-
-I had been using ikiwiki for a while without any problems. Recently, however, I'm having a problem with the web editor: accented characters are "mangled" by the wiki. For instance, if I type the character "á", it is rendered as "á". If I look (with `less`) at the html file generated by ikiwiki, I see: `<p>�<83>¡</p>` (the ? sign looks like a square in xterm). More details:
-
-* My machine's locale is en_US.utf8
-* In my ikiwiki setup file I have `locale => 'en_US.utf-8'`
-* If I edit a file in vim, add accented characters, and render the wiki from the command line, the page displays correctly. The problem only appears when using the web editor.
-* I am using perl 5.10.0.
-* The problem appears even when previewing the page; I don't have to save it. I believe this rules out any RCS misconfiguration.
-* If I edit a page with accented characters in the web editor, and then preview it without making any changes, all accented characters are mangled.
-* I updated the system's packages before the problem appeared. I didn't have time to work on my wiki for a few weeks, so I can't point out which update could be guilty.
-* I am running ikiwiki 2.44.
-
-I have googled all over the place and I can't find any mention of a similar problem, which makes me think this is a configuration problem on my end and not a bug. It likely has to do with UTF8; I am at a loss about how to fix (or even diagnose) this, though, and I'd appreciate any pointers.
+> This might be related to [Text::Markdown bug #37297](http://rt.cpan.org/Public/Bug/Display.html?id=37297).--ChapmanFlack 9Jul2008

 
 ----
 
 
 ----
 


@@ -109,7 +96,7 @@ I'd like to install ikiwiki as a non-root user. I can plow through getting all t
 perl dependencies installed because that's well documented in the perl world,
 but I don't know how to tell ikiwiki to install somewhere other than / --BrianWilson
 
 perl dependencies installed because that's well documented in the perl world,
 but I don't know how to tell ikiwiki to install somewhere other than / --BrianWilson
 

-> Checkout the tips section for [[tips/SharedHosting]].  It should do the trick. --MattReynolds
+> Checkout the tips section for [[tips/DreamHost]].  It should do the trick. --MattReynolds

 
 ----
 
 
 ----
 


@@ -281,7 +268,7 @@ easily, perl is possible (but I'm not strong in perl).
 
 > Jamey Sharp and I have a set of scripts in progress to convert other wikis to ikiwiki, including history, so that we can migrate a few of our wikis.  We already have support for migrating MoinMoin wikis to ikiwiki, including conversion of the entire history to Git.  We used this to convert the [XCB wiki](http://xcb.freedesktop.org/wiki/) to ikiwiki; until we finalize the conversion and put the new wiki in place of the old one, you can browse the converted result at <http://xcb.freedesktop.org/ikiwiki>.  We already plan to add support for TWiki (including history, since you can just run parsecvs on the TWiki RCS files to get Git), so that we can convert the [Portland State Aerospace Society wiki](http://psas.pdx.edu) (currently in Moin, but with much of its history in TWiki, and with many of its pages still in TWiki format using Jamey's TWiki format for MoinMoin).
 >
 
 > Jamey Sharp and I have a set of scripts in progress to convert other wikis to ikiwiki, including history, so that we can migrate a few of our wikis.  We already have support for migrating MoinMoin wikis to ikiwiki, including conversion of the entire history to Git.  We used this to convert the [XCB wiki](http://xcb.freedesktop.org/wiki/) to ikiwiki; until we finalize the conversion and put the new wiki in place of the old one, you can browse the converted result at <http://xcb.freedesktop.org/ikiwiki>.  We already plan to add support for TWiki (including history, since you can just run parsecvs on the TWiki RCS files to get Git), so that we can convert the [Portland State Aerospace Society wiki](http://psas.pdx.edu) (currently in Moin, but with much of its history in TWiki, and with many of its pages still in TWiki format using Jamey's TWiki format for MoinMoin).
 >

-> Our scripts convert by way of HTML, using portions of the source wiki's code to render as HTML (with some additional code to do things like translate MoinMoin's `\[[TableOfContents]]` to ikiwiki's `\[[toc ]]`), and then using a modified [[cpan HTML::WikiConverter]] to turn this into markdown and ikiwiki.  This produces quite satisfactory results, apart from things that don't have any markdown equivalent and thus remain HTML, such as tables and definition lists.  Conversion of the history occurs by first using another script we wrote to translate MoinMoin history to Git, then using our git-map script to map a transformation over the Git history.
+> Our scripts convert by way of HTML, using portions of the source wiki's code to render as HTML (with some additional code to do things like translate MoinMoin's `\[[TableOfContents]]` to ikiwiki's `\[[!toc ]]`), and then using a modified [[!cpan HTML::WikiConverter]] to turn this into markdown and ikiwiki.  This produces quite satisfactory results, apart from things that don't have any markdown equivalent and thus remain HTML, such as tables and definition lists.  Conversion of the history occurs by first using another script we wrote to translate MoinMoin history to Git, then using our git-map script to map a transformation over the Git history.

 >
 > We will post the scripts as soon as we have them complete enough to convert our wikis.
 >
 >
 > We will post the scripts as soon as we have them complete enough to convert our wikis.
 >


@@ -301,6 +288,10 @@ easily, perl is possible (but I'm not strong in perl).
 
 >>> It appears the scripts were never posted?  I recently imported my Mediawiki site into Iki.  If it helps, my notes are here: <http://iki.u32.net/Mediawiki_Conversion> --[[sabr]]
 
 
 >>> It appears the scripts were never posted?  I recently imported my Mediawiki site into Iki.  If it helps, my notes are here: <http://iki.u32.net/Mediawiki_Conversion> --[[sabr]]
 

+>>>>> The scripts have been posted now, see [[joshtriplett]]'s user page, 
+>>>>> and I've pulled together all ways I can find to [[convert]] other
+>>>>> systems into ikiwiki. --[[Joey]]
+

 ----
 
 # LaTeX support?
 ----
 
 # LaTeX support?


@@ -424,7 +415,7 @@ I'm sure that this is documented somewhere but I've ransacked the wiki and I can
 > The default `wiki_file_regexp` matches filenames containing only
 > `[-[:alnum:]_.:/+]`
 > 
 > The default `wiki_file_regexp` matches filenames containing only
 > `[-[:alnum:]_.:/+]`
 > 

-> The IkiWiki::titlepage() function will convert freeform text to a valid
+> The titlepage() function will convert freeform text to a valid

 > page name. See [[todo/should_use_a_standard_encoding_for_utf_chars_in_filenames]]
 > for an example. --[[Joey]]
 
 > page name. See [[todo/should_use_a_standard_encoding_for_utf_chars_in_filenames]]
 > for an example. --[[Joey]]