A while back in off-list discussion with me, Werner agreed in principle to moving our Wiki from its present location (http://www.miscdebris.net/plplot_wiki/) to our SourceForge project site. The strong motivation for such a move is to not have one single point of failure (Werner) if anything goes wrong with that miscdebris.net site.
Having agreed in principle, Werner did not actually make the move in part because he could not find clear instructions about how to do that from the SF documentation. I have just discovered one issue that complicates such a move (and probably is the reason that Werner could find no documentation); the format of the contents of our miscdebris site is wikimedia format, while markdown format is used for the Allura-based SF wikis. Fortunately, it turns out that the latest version of pandoc (1.13.1, but not older versions such as Debian stable's 1.9.4) can convert from mediawiki to markdown format converter. So I tried that for the conversion of one page of miscdebris content as a proof of concept. I installed the latest version of pandoc following the directions at <http://johnmacfarlane.net/pandoc/installing.html>. After I put those built results on my path, I converted the sample page with no issues using pandoc --read=mediawiki --write=markdown test.mediawiki > test.markdown and you can see the results at <https://sourceforge.net/p/plplot/wiki/Building_PLplot/> This result (aside from a TOC that apparently mediawiki software provides automatically since it is not explicitly in the mediawiki text for the page) has the same sections, paragraphs, links, and wording as http://www.miscdebris.net/plplot_wiki/index.php?title=Building_8PLplot. Thus, this result largely validates this proof of concept. There are some issues such as a markdown processing bugs for Allura where all line feeds in the document are considered to be line breaks The Allura bug tracker bug report for this issue <http://sourceforge.net/p/allura/tickets/4423/> includes a comment from a developer this was intentional behaviour. Despite the bug reporter protesting about that assertion the report was silently closed. My feeling is that Allura developers have decided to go with absolutely dumbed-down markdown behaviour concerning linefeeds in documents since they use markdown documents for all sorts of purposes. But it does seem a shame they are limiting results this way. I did discover from experiments with hand editing that if the linefeeds are removed from within paragraphs then the line wrapping of those paragraphs assumes a reasonable but fixed browser GUI width. For example, I did this experimental change for the first paragraph involving mention of DJGPP, and you should notice the broader line wrapping for that paragraph compared to the rest of the document which has rather short line breaks at the end of every line of every paragraph. To follow up a bit on this initial acceptable SF Wiki result, I have now downloaded all of the miscdebris wiki site (excluding the tarballs to save a huge amount in the download). From looking through man pages and trying some experiments it appears that a combination of tidy, xml, pandoc, sed, and (ahem) bash magic should be able to convert the essential parts the contents of the <textarea> tag (for the 64 files that have those) to ~64 files in markdown format with linebreaks removed from within paragraphs. I am fairly confident I can implement a bash shell script to do all of this automatically, but that implementation will obviously take some time. But so far so good with the project of moving our mediawiki based current wiki to the markdown-based SF wiki. Also, once that project has been completed the markdown format <http://sourceforge.net/p/forge/documentation/markdown_syntax/> we would need to use for further hand-editing of our SF Wiki is quite straightforward to use. Alan __________________________ Alan W. Irwin Astronomical research affiliation with Department of Physics and Astronomy, University of Victoria (astrowww.phys.uvic.ca). Programming affiliations with the FreeEOS equation-of-state implementation for stellar interiors (freeeos.sf.net); the Time Ephemerides project (timeephem.sf.net); PLplot scientific plotting software package (plplot.sf.net); the libLASi project (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project (lbproject.sf.net). __________________________ Linux-powered Science __________________________ ------------------------------------------------------------------------------ Meet PCI DSS 3.0 Compliance Requirements with EventLog Analyzer Achieve PCI DSS 3.0 Compliant Status with Out-of-the-box PCI DSS Reports Are you Audit-Ready for PCI DSS 3.0 Compliance? Download White paper Comply to PCI DSS 3.0 Requirement 10 and 11.5 with EventLog Analyzer http://pubads.g.doubleclick.net/gampad/clk?id=154622311&iu=/4140/ostg.clktrk _______________________________________________ Plplot-devel mailing list Plplot-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/plplot-devel
