On Sat, Mar 24, 2018 at 6:15 AM, Dominik Aumayr <[email protected]> wrote:
> 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. Glad you like it. > 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.) > I was hoping to fix the various formatting issues. > > > > Am 24.03.2018 um 05:35 schrieb Martin Blais <[email protected]>: > > > > 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/ > 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 <[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. > >> 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. > > > > 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. > > -- > 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/B459DD82-C862-47DC-A9FA-6D71E51807EE%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 [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%2BhMqgn%3DQ36cMkZJwBkop97u8SuPwQ8PA0eFE3k7DJTfenA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
