[pmwiki-users] minimal text file to create pmwiki page

[Tamara Temple]

Mark Lee <mark.lee.phd at gmail.com> wrote:
> I have a wiki from another system that I want to recreate in pmwiki. I have the contents of the pages stored in
> a spreadsheet. I will be writing a script to convert the text files into pmwiki pages. I found this:
> 
> Only two lines are necessary in a PmWiki page file:
> 
> version=pmwiki-2.1.0 urlencoded=1
> text=Markup text
> 
> "version=" tells PmWiki that the values are urlencoded. The actual value doesn't matter, as long as "urlencoded=
> 1" appears somewhere in the line.
> 
> "text=" needs to have the markup text with newlines converted to "%0a" and percent signs converted to "%25".
> 
> In addition, PmWiki writes pages with '<' encoded as "%3c" (to help with security), but it doesn't require that
> <'s be encoded that way in order to be able to read the page. More conversions are possible to be added in the
> future.
> 
> Is this all I need to add to the text files? I can't figure it out.
> 
> -Mark

Hi, Mark, welcome to PmWiki!

If you're old content is in plain text format, with the old wiki's
markup removed, it might be easier to do it using the
http://www.pmwiki.org/wiki/Cookbook/ImportText recipe. You can save each
page of your old wiki as a plain text file with the name of the page
with a .txt extension. Follow the instructions in the recipe to then
import them directly into pmwiki. This saves having to turn the plain
text files into the form expected on the text= line.

I use this recipe quite a lot when I do mass-editing of my wiki pages,
and it works a treat.

If you're old wiki pages in the spreadsheet still have the old wiki's
markup, you are not out of luck. There are some wiki converters out
there. If you can tell us the old wiki implementation, maybe we can help
out there, too.