This looks great! Thanks for working on this! :) > It's incomplete, but you can see how pretty darn close it is (it's readable, > but flawed).
Except for the code blocks (they should be in a monospaced font, as otherwise it would be confusing for the reader), and the sidebar (can be configured in Sphinx, afaik), this looks as pretty as I hoped for. How much work do you plan to put in until you "release" this? (As it looks like not much is needed for "release-readyness", imho.) > Am 24.03.2018 um 05:35 schrieb Martin Blais <bl...@furius.ca>: > > Thx Dominik. > > BTW, here's what the current automated conversion results looks like in your > static skeleton: > http://furius.ca/tmp/beancount-docs/ > > This was entirely produced by the code I wrote here, no manual changes: > https://bitbucket.org/blais/beancount/src/tip/experiments/docs_rst/ > > It's incomplete, but you can see how pretty darn close it is (it's readable, > but flawed). > > Quick comments: > - I haven't copied all the docs, just the ones you had linked in, it would be > easy to include more in the structure > - Some - but not all - of the code blocks are erroneous, they have an extra > duplicated unindented last line (probably a bug in convert_docs.py) > - Some of the **bold** and *italic* strings don't render as such, I don't > know why (input looks right) > - Some of the list items somehow have their indentation badly converted by > Pandoc > - The index on the left shows sections for the entire set of documents - this > is too much, should show sections for each document only > > I think post-processing the rst from Pandoc it would be possible to fix all > these things to make it a fully automated conversion. > > > > > On Thu, Mar 15, 2018 at 2:19 AM, Dominik Aumayr <domi...@aumayr.name> wrote: >> - Eventually I'd like to merge that into Beancount itself and maintain it >> (with Dominik's permission). > > Permission hereby granted :-) > > Am 14.03.2018 um 06:08 schrieb Martin Blais <bl...@furius.ca>: > >> I just cleaned up the hacky conversion code a bit. >> >> If anybody would like to have a go at completing this, the source is here: >> https://bitbucket.org/blais/beancount/src/tip/experiments/docs_rst/?at=default >> >> Instead of running the download_docs.py script, which might require a Google >> API token, I made an archive of what it downloads here: >> http://furius.ca/tmp/beancount-docs-downloaded/docs.tar.gz l (28MB) >> >> See the Makefile. >> What remains to be done is >> - Check that the output converts nicely >> - If not, find ways to automatedly fix it during the conversion, I'm not >> 100% sure that's possible (I'm hoping) >> - Integrate it in Dominik Aumayr's static docs and look at the converted text >> - Eventually I'd like to merge that into Beancount itself and maintain it >> (with Dominik's permission). >> >> >> >> On Sun, Mar 11, 2018 at 12:56 PM, Martin Blais <bl...@furius.ca> wrote: >> Not planning to move to rst as an input format. >> I still would use GDocs as input; just request comment access and I'll >> accept liberally. >> The idea would be to fully automate the conversion. >> (The only reason I made the docs RO was to avoid the numerous and frequent >> fingerfarts.) >> >> On Sat, Mar 10, 2018 at 6:43 PM, Martin Michlmayr <t...@cyrius.com> wrote: >> * Martin Blais <bl...@furius.ca> [2018-02-20 00:07]: >> > Anyhow, I'll try to finish this and convert all the docs to rst at some >> > point. >> >> Once the rst documents exist, are you going to accept pull requests >> with changes against the rst (and apply them to your canonical source) >> or how should people interested in working on docs submit changes? >> >> -- >> Martin Michlmayr >> http://www.cyrius.com/ >> >> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "Beancount" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to beancount+unsubscr...@googlegroups.com. >> To post to this group, send email to beancount@googlegroups.com. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/beancount/CAK21%2BhNTudNTXeuBaATdfFCk0q2_wV3HJd%3DZ8ZV5K3cgVm3Org%40mail.gmail.com. >> For more options, visit https://groups.google.com/d/optout. > > -- > You received this message because you are subscribed to the Google Groups > "Beancount" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to beancount+unsubscr...@googlegroups.com. > To post to this group, send email to beancount@googlegroups.com. > To view this discussion on the web visit > https://groups.google.com/d/msgid/beancount/9CBA7B3A-292A-4803-BD76-C8C4B1AA90B2%40aumayr.name. > > For more options, visit https://groups.google.com/d/optout. > > > -- > You received this message because you are subscribed to the Google Groups > "Beancount" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to beancount+unsubscr...@googlegroups.com. > To post to this group, send email to beancount@googlegroups.com. > To view this discussion on the web visit > https://groups.google.com/d/msgid/beancount/CAK21%2BhNx0Y8xofVqWE%2B07RfaHF19nLPQKjMwBrMnGNuGbF%2B5Kw%40mail.gmail.com. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Beancount" group. To unsubscribe from this group and stop receiving emails from it, send an email to beancount+unsubscr...@googlegroups.com. To post to this group, send email to beancount@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/beancount/B459DD82-C862-47DC-A9FA-6D71E51807EE%40aumayr.name. For more options, visit https://groups.google.com/d/optout.
