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 <[email protected]> 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 <[email protected]>: > > 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/do > cs_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 <[email protected]> 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 <[email protected]> wrote: >> >>> * Martin Blais <[email protected]> [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 [email protected]. > To post to this group, send email to [email protected]. > To view this discussion on the web visit https://groups.google.com/d/ > msgid/beancount/CAK21%2BhNTudNTXeuBaATdfFCk0q2_wV3HJd%3DZ8ZV5K3cgVm3Org% > 40mail.gmail.com > <https://groups.google.com/d/msgid/beancount/CAK21%2BhNTudNTXeuBaATdfFCk0q2_wV3HJd%3DZ8ZV5K3cgVm3Org%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > 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 [email protected]. > To post to this group, send email to [email protected]. > To view this discussion on the web visit https://groups.google.com/d/ > msgid/beancount/9CBA7B3A-292A-4803-BD76-C8C4B1AA90B2%40aumayr.name > <https://groups.google.com/d/msgid/beancount/9CBA7B3A-292A-4803-BD76-C8C4B1AA90B2%40aumayr.name?utm_medium=email&utm_source=footer> > . > > 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 [email protected]. To post to this group, send email to [email protected]. 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.
