Re: [Firebird-docs] First 'new' documents online
On 2020-05-27 08:37, Köditz wrote: Hi Mark, well, I misunderstood the document's structure. I just looked for the switch 'asciidocHtml' which already creates some kind of 'chunked' document. In the docbuilding howto you can only see 'docbookHtml'. But now I know how to work with it. The docbuilding howto also documents asciidocHtml: https://firebirdsql.org/file/documentation/html/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.html#docbuildhowto-building-output-docs However, that doesn't produce chunked output. Since I already have CMS access I should be able to publish the docs by myself. Otherwise I will call for help. Ok, that is fine. However, there is more necessary than just publishing the new docs: I also need to coordinate with Sergey to add redirects from the old documents to the new documents (if only so bookmarks and published links elsewhere will continue to work and point to the new docs). So if you publish new documents, let me know which, so I can set this up. Mark ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Hi Mark, well, I misunderstood the document's structure. I just looked for the switch 'asciidocHtml' which already creates some kind of 'chunked' document. In the docbuilding howto you can only see 'docbookHtml'. But now I know how to work with it. Since I already have CMS access I should be able to publish the docs by myself. Otherwise I will call for help. Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
To avoid any chance of miscommunication and possible double work, could you let me know what document you are looking to translate, and how you want to approach this? Mark On 2020-05-26 15:17, Köditz wrote: Please, forget my previous Mail. I found everything in the new Docs. But how can I create the chunked output? Regards Martin Hi Mark, I'd like to update the German docs. What do I have to do? Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 2020-05-26 15:17, Köditz wrote: Please, forget my previous Mail. I found everything in the new Docs. But how can I create the chunked output? You can't create chunked output, that is something we 'lose' in the migration. That is also why, when migrating, I'm defining redirects from the old chunked html files to the new single page html file. Mark ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 2020-05-26 14:56, Köditz wrote: Hi Mark, I'd like to update the German docs. What do I have to do? I can do the initial conversion to asciidoc for existing German docs, and then you can take it from there. However, playing devil's advocate: is investing time in translating the Docbuilding Howto and Docwriting Guide really worth the effort, wouldn't that be better invested in translating end-user documentation? Also I'd like to raise the question: what to do with translated docs that aren't actively maintained? Keep them as-is and maybe delete them from the site, or convert and republish? Mark ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Hi Martin, I don't believe that you can, currently, create chunked HTML with Asciidoctor. s Mark stated in his thread recently about Chunked HTML: Asciidoctor does not support chunked HTML output (there is an experimental, third-party plugin, but that plugin is tied to a specific, out-of-date asciidoctor version). HTH Cheers, Norm. On 26/05/2020 14:17, Köditz, Martin wrote: Please, forget my previous Mail. I found everything in the new Docs. But how can I create the chunked output? Regards Martin Hi Mark, I'd like to update the German docs. What do I have to do? Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Please, forget my previous Mail. I found everything in the new Docs. But how can I create the chunked output? Regards Martin > Hi Mark, > > I'd like to update the German docs. What do I have to do? > > Regards > Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Hi Mark, I'd like to update the German docs. What do I have to do? Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 23-05-2020 14:30, Mark Rotteveel wrote: I have migrated the first documents to asciidoc: - Docbuilding Howto - HTML https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docbuildhowto/firebird-docbuilding-guide.html - PDF https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.pdf - Docwriting Guide - HTML https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docwritehowto/firebird-docwriting-guide.html - PDF https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docwritehowto/firebird-docwriting-howto.pdf I have also updated them to have information about the new situation. I haven't updated the documentation index yet, because I first need to identify which redirects need to be added so old links continue to work. Forgot to update yesterday: links for the Docbuilding Howto and Docwriting Guide are now updated, and redirects are in place for the old PDF and HTML. Old links, even for the chunked html, will continue to work. Links to the old pages using fragment identifiers to point to a section will select the section correctly (assuming the id still exists in the new doc), but links to the chunked page itself (so without a fragment identifier), will link to the top of the new document, instead of the section of the old chunk. Fragment identifiers are not included in a request, so we can't send a redirect that includes the right section-id in that situation, as that would break more specific links that do use a fragment identifier to link to a specific section. Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Mark Rotteveel wrote: >> Ok, I'll change it to media-type screen, which will start a chapter on a >> new page, but doesn't care if it is recto or verso. > > And published Thanks, Mark! Cheers, Paul ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 25-05-2020 20:10, Mark Rotteveel wrote: On 25-05-2020 19:33, Paul Vinkenoog wrote: Mark Rotteveel wrote: Is it possible to generate the PDF's so that chapters start on a fresh page but not necessarily on an uneven page, like they do now? These blank pages between chapters are irritating when reading on-screen. As I thought the primary reason we had PDF was for those wanting to print out the documentation (otherwise, why not use HTML?), I used the 'prepress' option, which will automatically set chapters on the recto page. I will try one of the other options and see what the results are. I wonder how many people print them. Myself, I follow HTML links for quick lookups, but for longer reads I prefer PDF's. But maybe I'm the exception. Ok, I'll change it to media-type screen, which will start a chapter on a new page, but doesn't care if it is recto or verso. And published -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 25-05-2020 19:33, Paul Vinkenoog wrote: Mark Rotteveel wrote: Is it possible to generate the PDF's so that chapters start on a fresh page but not necessarily on an uneven page, like they do now? These blank pages between chapters are irritating when reading on-screen. As I thought the primary reason we had PDF was for those wanting to print out the documentation (otherwise, why not use HTML?), I used the 'prepress' option, which will automatically set chapters on the recto page. I will try one of the other options and see what the results are. I wonder how many people print them. Myself, I follow HTML links for quick lookups, but for longer reads I prefer PDF's. But maybe I'm the exception. Ok, I'll change it to media-type screen, which will start a chapter on a new page, but doesn't care if it is recto or verso. Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
25.05.2020 20:33, Paul Vinkenoog wrote: As I thought the primary reason we had PDF was for those wanting to print out the documentation (otherwise, why not use HTML?), I used the 'prepress' option, which will automatically set chapters on the recto page. I will try one of the other options and see what the results are. I wonder how many people print them. Myself, I follow HTML links for quick lookups, but for longer reads I prefer PDF's. But maybe I'm the exception. Same here. For me, PDF is always preferred not because it's printable, but because it's downloadable. If I have a copy on my PC, then I will never read the same from the web ;-) Dmitry ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Mark Rotteveel wrote: >> Is it possible to generate the PDF's so that chapters start on a fresh >> page but not necessarily on an uneven page, >> like they do now? These blank pages between chapters are irritating >> when reading on-screen. > > As I thought the primary reason we had PDF was for those wanting to > print out the documentation (otherwise, why not use HTML?), I used the > 'prepress' option, which will automatically set chapters on the recto > page. I will try one of the other options and see what the results are. I wonder how many people print them. Myself, I follow HTML links for quick lookups, but for longer reads I prefer PDF's. But maybe I'm the exception. Cheers, Paul ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 2020-05-25 14:35, Paul Vinkenoog wrote: Mark Rotteveel wrote: I have migrated the first documents to asciidoc: Looking good! https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.pdf Is it possible to generate the PDF's so that chapters start on a fresh page but not necessarily on an uneven page, like they do now? These blank pages between chapters are irritating when reading on-screen. As I thought the primary reason we had PDF was for those wanting to print out the documentation (otherwise, why not use HTML?), I used the 'prepress' option, which will automatically set chapters on the recto page. I will try one of the other options and see what the results are. However, personally, this doesn't really bother me. Mark ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Mark Rotteveel wrote: > I have migrated the first documents to asciidoc: Looking good! > https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.pdf Is it possible to generate the PDF's so that chapters start on a fresh page but not necessarily on an uneven page, like they do now? These blank pages between chapters are irritating when reading on-screen. Cheers, Paul ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
On 23-05-2020 14:30, Mark Rotteveel wrote: I have migrated the first documents to asciidoc: - Docbuilding Howto - HTML https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docbuildhowto/firebird-docbuilding-guide.html This should have been https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.html - PDF https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.pdf - Docwriting Guide - HTML https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docwritehowto/firebird-docwriting-guide.html - PDF https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docwritehowto/firebird-docwriting-howto.pdf This should have been https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docwritehowto/firebird-docwriting-guide.pdf Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
[Firebird-docs] First 'new' documents online
I have migrated the first documents to asciidoc: - Docbuilding Howto - HTML https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docbuildhowto/firebird-docbuilding-guide.html - PDF https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.pdf - Docwriting Guide - HTML https://www.firebirdsql.org/file/documentation/html/en/firebirddocs/docwritehowto/firebird-docwriting-guide.html - PDF https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docwritehowto/firebird-docwriting-howto.pdf I have also updated them to have information about the new situation. I haven't updated the documentation index yet, because I first need to identify which redirects need to be added so old links continue to work. Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
