On 2014-09-29 23:40-0700 Alan W. Irwin wrote: > 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.
I wrote a script to automate all the required conversions and sed fixups (since pandoc is not perfect) and the result is 52 files that are formatted correctly with markdown and thus suitable for our SF wiki site. The remaining task is to upload those markdown files to our SF wiki and do light editing of them if that is required to get them to look like the corresponding miscdebris results. It turns out (see recent thread on this) that because of authentication issues you cannot use wget or curl to mass-POST those files to our wiki site. Thus, the only recourse is cut and paste. However, I have found one nice way to speed up the cut part of that which is to use cat Configuration_of_wxWidgets_driver |xclip -i to cut those file results into the appropriate X buffer, then afterwards you have to create the "Configuration_of_wxWidgets_driver" page using the appropriate click on our SF wiki GUI, and middle click the mouse to paste the appropriate contents into that wiki. I have now done 9 of those, and the process has been relatively painless except for the last one, Configuration_of_wxWidgets_driver, which was a special case that included images. I had to modify the converted markdown command for displaying those images, I had to find the relevant png files in the mess of files I downloaded from the miscdebris site, I had to resize those images which were slightly too large, and I had to upload those two file results to the wiki page. As a result of those steps, I think <https://sourceforge.net/p/plplot/wiki/Configuration_of_wxWidgets_driver/> looks remarkably like <http://www.miscdebris.net/plplot_wiki/index.php?title=Configuration_of_wxWidgets_driver> which, of course, is the whole point of this conversion project. So I am now done with this page and moving on to cutting and pasting (and light editing of) the remaining converted markdown pages with the goal that all pages of the SF wiki result should look very similar to the corresponding miscdebris result to provide a good starting point for further wiki changes at our SF wiki site. Speaking of which, I did notice <https://sourceforge.net/p/plplot/wiki/Configuration_of_wxWidgets_driver/> was a bit dated so if someone with a wxwidgets interest (ahem, Phil?) wants to modernize that page by doing appropriate editing or uploading of images reflecting more recent results, then I would strongly encourage that activity since all our wiki pages should be considered the joint responsibility of everyone here who wants to help out with PLplot documentation. Note that right now those that can write material for our wiki are limited to core developers, but if some non-core developer here is interested in helping out with the wiki, then please let me know, and the appropriate SF permissions for wiki write access alone are easy to arrange. 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
