Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-23 Thread Mark Rotteveel
On 23-6-2018 16:44, Simonov Denis via Firebird-docs wrote: Mark Rotteveel wrote Thu, 14 Jun 2018 17:04:56 +0300: I tried to translate a small project from docbook to asciidoc. Conversion was successful, but some moments had to be finalized manually. Yes, some tweaks are needed. It might be

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-23 Thread Simonov Denis via Firebird-docs
Mark Rotteveel wrote Thu, 14 Jun 2018 17:04:56 +0300: I tried to translate a small project from docbook to asciidoc. Conversion was successful, but some moments had to be finalized manually. Then I tried to generate html, it turned out well even with standard styles. I tried to generate

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-22 Thread Mark Rotteveel
On 22-6-2018 11:41, Köditz, Martin wrote: Hi, is there a chance to get an online editor with asciidoc? Something like https://asciidoclive.com/edit/scratch/1. I think that would be very helpful as some people have trouble setting up a suitable environment. You can always work with an online

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-22 Thread Norman Dunbar
Issue 921 opened on github. (Asciidoctor-pdf) Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity and any "auto corrections" that are just wrong!-- Check out the vibrant tech community

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-22 Thread Köditz , Martin
Hi, is there a chance to get an online editor with asciidoc? Something like https://asciidoclive.com/edit/scratch/1. I think that would be very helpful as some people have trouble setting up a suitable environment. You can always work with an online editor. And if it is only for a few lines.

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-22 Thread Mark Rotteveel
On 2018-06-21 21:04, Norman Dunbar wrote: On the grounds of experimenting, I've been able to install asciidoctor and asciidoctor-pdf at work and I'm quite impressed now at how well it has come on since I last looked at it. I would like to be able to convert to EPUBs as well as HTML and PDF, but

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-21 Thread Norman Dunbar
On the grounds of experimenting, I've been able to install asciidoctor and asciidoctor-pdf at work and I'm quite impressed now at how well it has come on since I last looked at it. I would like to be able to convert to EPUBs as well as HTML and PDF, but it's proving a tad difficult to get the

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-17 Thread Mark Rotteveel
On 16-6-2018 15:42, Paul Vinkenoog wrote: I was wondering how people think about migrating from docbook to asciidoc. Asciidoc is an "almost plain text" format that is used a lot these days for documentation (as an example, Hibernate and Spring switched from docbook to asciidoc), as its markup is

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-16 Thread Paul Vinkenoog
Mark Rotteveel wrote: > I'm trying to modernize the build of the documentation by converting it > to gradle (which should allow us to do away with manual setup and > downloading of things, and may fix issues with more recent Java > versions), That would be a very good thing. > I was

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-16 Thread Dmitry Yemanov
16.06.2018 10:14, Mark Rotteveel wrote: Seconded, the output looks very good. I would support switching to this toolset if it can handle our requirements. I think the output should not be a deciding factor. If that is the thing that counts, then overhauling the existing docbook stylesheets

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-16 Thread Mark Rotteveel
On 16-6-2018 09:01, Dmitry Yemanov wrote: 15.06.2018 12:26, Alexey Kovyazin wrote: I like the result - html docs looks really cool. Also, I think it is more suitable for the translation. Seconded, the output looks very good. I would support switching to this toolset if it can handle our

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-16 Thread Dmitry Yemanov
15.06.2018 12:26, Alexey Kovyazin wrote: I like the result - html docs looks really cool. Also, I think it is more suitable for the translation. Seconded, the output looks very good. I would support switching to this toolset if it can handle our requirements. Dmitry

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-16 Thread Mark Rotteveel
On 16-6-2018 00:05, Norman Dunbar wrote: Yes indeed, it does look smart. Unfortunately, the pdf of isql suffers from formatting errors, in justification, Appendix A - second line, first paragraph for example. I have used the default asciidoctor-pdf theme for generating the PDF, and that

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-15 Thread Norman Dunbar
Yes indeed, it does look smart. Unfortunately, the pdf of isql suffers from formatting errors, in justification, Appendix A - second line, first paragraph for example. I trie asciidoc and asciidoctor some time back, but I didn't get on with it/them. I used Sphinx-doc for a project a while

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-15 Thread Mark Rotteveel
As a more complete example, you can also take a look at the jaybird-manual at https://github.com/FirebirdSQL/jaybird-manual Its build automatically published to https://firebirdsql.github.io/jaybird-manual/jaybird_manual.html Mark On 14-6-2018 16:04, Mark Rotteveel wrote: I'm trying to

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-15 Thread Paul Beach
Mark, Thats very smart I like it. Regards Paul > -Original Message- > From: Mark Rotteveel [mailto:m...@lawinegevaar.nl] > Sent: 14 June 2018 16:05 > To: Chatter regarding Firebird documentation > Subject: [Firebird-docs] Experimenting with asciidoc / asciidoctor &

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-15 Thread Mark Rotteveel
On 15-6-2018 11:26, Alexey Kovyazin wrote: Hello, I like the result - html docs looks really cool. Also, I think it is more suitable for the translation. Do you have PDF version to take a look at? I have now also added PDF versions on https://mrotteveel.github.io/firebird-documentation/

Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-15 Thread Alexey Kovyazin
Hello, I like the result - html docs looks really cool. Also, I think it is more suitable for the translation. Do you have PDF version to take a look at? Regards, Alexey Kovyazin IBSurgeon On 14.06.2018 17:04, Mark Rotteveel wrote: I'm trying to modernize the build of the documentation by

[Firebird-docs] Experimenting with asciidoc / asciidoctor

2018-06-14 Thread Mark Rotteveel
I'm trying to modernize the build of the documentation by converting it to gradle (which should allow us to do away with manual setup and downloading of things, and may fix issues with more recent Java versions), but I got side-tracked into experimenting with asciidoc / asciidoctor (see