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 > > > I'm trying to

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