On 9 February 2015 at 19:33, leaf corcoran <[email protected]> wrote: > On Mon, Feb 9, 2015 at 1:17 PM, Ignacio Burgueño <[email protected]> > wrote: >> >> You could host the docs in a git branch, and use the github-pages feature >> plus a static site generator? (Like, I don't know, Octopress or Jekyll?) >> Or use the Wiki feature of Github?
Once I learned that Github's wiki feature supports MediaWiki syntax, I tried to simply upload the files with .wiki syntax extension there and everything worked virtually out-of-the-box (I just had to rename files from This_syntax.wiki to This-syntax.wiki). >> Or maybe Leaf has already written a Wiki engine in Lapis :) > > Wiki in Lapis planned but I haven't started yet :). > > It would be nice to have the pages as regular markdown. I can also put them > in the repository for moonrocks site and just render them directly in the > site without having to link externally. We could also hook up the > appropriate links between the pages when necessary. Having the docs integrated in the main site would be nice. Perhaps there's a library somewhere that converts between those formats? Anyway, it was nice to have the luarocks.org site/docs as a wiki. In spite of having to deal with spam occasionally, there were quite a few occasions where users contributed significant docs. Perhaps having it in a way that makes it easy for people to send pull requests it could work just as well. -- Hisham ------------------------------------------------------------------------------ Dive into the World of Parallel Programming. The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net/ _______________________________________________ Luarocks-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/luarocks-developers
