# Moving Reference Guide to Wiki **URL:** \ **Category:** Development\ **Created:** [August 11, 2010, 1:20pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171 "2010-08-11T13:20:55Z")\ **Posts on this page:** 14\ **Page:** 1
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 11, 2010, 1:20pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/1 "2010-08-11T13:20:55Z")
I’ve started the process of moving our Reference Guide to the wiki. It will probably take me a couple of weeks to port it over. Having our reference guide in a wiki will have the advantage of making it easy for anyone to update the documentation, keeping it accurate and in sync with the latest version of VASSAL. Once the project is done, we might want to consider changing the VASSAL distribution so that it no longer ships with HTML but rather points to the wiki. I am working from the HTML Reference Guide that ships with 3.1.14. Is this the most up-to-date version of the docs? I recall reading in the forums that someone was working on updating the guide–I wouldn’t want my work to get out of sync with this initiative. P.S. I’m using the perl tool html2wiki to do most of the heavy lifting, then doing a bit of automated post-processing on my own. ---
**Author:** ![uckelman](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/uckelman/32/10020_2.png) [@uckelman](https://forum.vassalengine.org/u/uckelman)\ **Post date:** [August 11, 2010, 2:57pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/2 "2010-08-11T14:57:19Z")
Thus spake fil512: > Once the project is done, we might want to consider changing the VASSAL > distribution so that it no longer ships with HTML but rather points to > the wiki. I see two problems with this: 1. It’s nice to have access to reference materials off-line. 2. If the RG in the wiki follows the current version of VASSAL and something changes, where will people find the version of the RG for older versions? – J. ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 11, 2010, 3:09pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/3 "2010-08-11T15:09:21Z")
> [@uckelman](#): > > Thus spake fil512: > > > Once the project is done, we might want to consider changing the VASSAL > > distribution so that it no longer ships with HTML but rather points to > > the wiki. > > I see two problems with this: > > 1. It’s nice to have access to reference materials off-line. > > 2. If the RG in the wiki follows the current version of VASSAL and > something changes, where will people find the version of the RG for > older versions? > > – > J. Good points. At a certain point, my hope is that the wiki version of the docs will be of significantly higher quality and accuracy than the HTML docs we have now. Could we generate the HTML that ships with VASSAL from the wiki pages somehow? -K ---
**Author:** ![uckelman](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/uckelman/32/10020_2.png) [@uckelman](https://forum.vassalengine.org/u/uckelman)\ **Post date:** [August 11, 2010, 3:34pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/4 "2010-08-11T15:34:26Z")
Thus spake fil512: > At a certain point, my hope is that the wiki version of the docs will be > of significantly higher quality and accuracy than the HTML docs we have > now. I think that won’t take long. > Could we generate the HTML that ships with VASSAL from the wiki > pages somehow? I’m sure there’s a package in CPAN which will do it, if MediaWiki can’t do it itself. – J. ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 11, 2010, 5:35pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/5 "2010-08-11T17:35:22Z")
FYI the Reference manual is now completely converted to the wiki. Some of the wiki formatting doesn’t look good (e.g. I don’t like what it did with H4s–translating them into grey boxes with small courier font). And some of the widths look off. But by and large I think it’s functioning. Next step is to start bringing it up to date with the current Vassal engine. I’ll spend some time doing that in the coming weeks. Ken P.S. After I ran the html2wiki script to convert the html to wiki format, I hired my 13 year old son for $25 to copy/paste all the pages and images up to the site… ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 11, 2010, 5:36pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/6 "2010-08-11T17:36:33Z")
> [@fil512](#): > > FYI the Reference manual is now completely converted to the wiki. > > Next step is to start bringing it up to date with the current Vassal engine. I’ll spend some time doing that in the coming weeks. If any of you feel inclined to help clean up some of the formatting for us, we’d all be much obliged! ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 11, 2010, 6:18pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/7 "2010-08-11T18:18:45Z")
Correction: I just noticed that my son missed a few pages and images. I’ll post again when I think he got them all. ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 11, 2010, 6:26pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/8 "2010-08-11T18:26:21Z")
By the way, if you see a grey box around a block of text in courier font, I discovered it’s because there is a space at the start of the line. This is an artifact of how the HTML got translated into wiki. If you see one of these, you can fix it by deleting the space at the start of the line. -K ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 12, 2010, 2:22am UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/9 "2010-08-12T02:22:33Z")
The Reference Guide is now completely moved into the site wiki. ---
**Author:** ![uckelman](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/uckelman/32/10020_2.png) [@uckelman](https://forum.vassalengine.org/u/uckelman)\ **Post date:** [August 12, 2010, 8:16am UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/10 "2010-08-12T08:16:16Z")
Thus spake fil512: > The Reference Guide is now completely moved into the site wiki. Wonderful. Thank you. – J. ---
**Author:** ![Brent\_Easton](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/brent_easton/32/10_2.png) [@Brent\_Easton](https://forum.vassalengine.org/u/Brent_Easton)\ **Post date:** [August 13, 2010, 9:13am UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/11 "2010-08-13T09:13:03Z")
> The Reference Guide is now completely moved into the site wiki. Excellent work. But the the need to be able to export/convert the wiki into either HTML or PDF is pretty vital. Be careful about making drastic changes until we are sure we can generate an off-line manual automatically. B. ---
**Author:** ![fil512](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/fil512/32/2661_2.png) [@fil512](https://forum.vassalengine.org/u/fil512)\ **Post date:** [August 13, 2010, 6:50pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/12 "2010-08-13T18:50:12Z")
> [@swampwallaby](#): > > > The Reference Guide is now completely moved into the site wiki. > > Excellent work. But the the need to be able to export/convert the wiki into either HTML or PDF is pretty vital. Be careful about making drastic changes until we are sure we can generate an off-line manual automatically. > > B. B, I’m very confident that any number of standard web site spider programs will be able to walk the site and produce the HTML and images needed to render the documentation offline as a set of web pages as it is now. The documentation is presently structured as linked web pages–I’m not sure how well it would translate to PDF–probably not worth the trouble. -K ---
**Author:** ![Brent\_Easton](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/brent_easton/32/10_2.png) [@Brent\_Easton](https://forum.vassalengine.org/u/Brent_Easton)\ **Post date:** [August 13, 2010, 10:40pm UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/13 "2010-08-13T22:40:46Z")
> I’m very confident that any number of standard web site spider programs > will be able to walk the site and produce the HTML and images needed to > render the documentation offline as a set of web pages as it is now. > The documentation is presently structured as linked web pages–I’m not > sure how well it would translate to PDF–probably not worth the trouble. I’m quite confident that you will find a tool to do this also, there are many, many listed on the Mediawiki Alternative Parsers page. I am less confident that you will find a tool that will be easy to use and produces something that looks good. I don’t want to be overly negative, but if I was you, I would make that my first priority to see exactly where we stand. Cheers, B. ---
**Author:** ![uckelman](https://forum.vassalengine.org/user_avatar/forum.vassalengine.org/uckelman/32/10020_2.png) [@uckelman](https://forum.vassalengine.org/u/uckelman)\ **Post date:** [August 14, 2010, 7:10am UTC](https://forum.vassalengine.org/t/moving-reference-guide-to-wiki/3171/14 "2010-08-14T07:10:18Z")
Thus spake “Brent Easton”: > > I’m very confident that any number of standard web site spider programs > > will be able to walk the site and produce the HTML and images needed to > > render the documentation offline as a set of web pages as it is now. > > The documentation is presently structured as linked web pages–I’m not > > sure how well it would translate to PDF–probably not worth the trouble. > > I’m quite confident that you will find a tool to do this also, there are many > , many listed on the Mediawiki Alternative Parsers page. I am less confident > that you will find a tool that will be easy to use and produces something th > at looks good. > > I don’t want to be overly negative, but if I was you, I would make that my fi > rst priority to see exactly where we stand. I’ll see about this soon, but I’m not sure I’ll be able to get to it before I come back from Portugal next Saturday. – J.