Menu
▾
▴
firebird-docs — chat stuff about documentation
You can subscribe to this list here.
| 2001 |
Jan
|
Feb
(1) |
Mar
|
Apr
(36) |
May
(56) |
Jun
(1) |
Jul
(5) |
Aug
(3) |
Sep
(1) |
Oct
|
Nov
|
Dec
(1) |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2002 |
Jan
|
Feb
|
Mar
(15) |
Apr
(5) |
May
(7) |
Jun
(5) |
Jul
(3) |
Aug
(6) |
Sep
(3) |
Oct
(8) |
Nov
(23) |
Dec
(21) |
| 2003 |
Jan
(25) |
Feb
(37) |
Mar
(59) |
Apr
(11) |
May
(8) |
Jun
(24) |
Jul
(18) |
Aug
(29) |
Sep
(30) |
Oct
(11) |
Nov
(20) |
Dec
(5) |
| 2004 |
Jan
(43) |
Feb
(24) |
Mar
(61) |
Apr
(14) |
May
(23) |
Jun
(50) |
Jul
(13) |
Aug
(56) |
Sep
(55) |
Oct
(64) |
Nov
(94) |
Dec
(27) |
| 2005 |
Jan
(40) |
Feb
(10) |
Mar
(55) |
Apr
(20) |
May
(16) |
Jun
(6) |
Jul
(58) |
Aug
(38) |
Sep
(5) |
Oct
(6) |
Nov
(71) |
Dec
(99) |
| 2006 |
Jan
(6) |
Feb
(15) |
Mar
(22) |
Apr
(9) |
May
(31) |
Jun
(35) |
Jul
(47) |
Aug
(18) |
Sep
(21) |
Oct
(24) |
Nov
(63) |
Dec
(79) |
| 2007 |
Jan
(22) |
Feb
(40) |
Mar
(47) |
Apr
(69) |
May
(22) |
Jun
(20) |
Jul
(25) |
Aug
(13) |
Sep
(7) |
Oct
(44) |
Nov
(76) |
Dec
(1) |
| 2008 |
Jan
(26) |
Feb
(30) |
Mar
(120) |
Apr
(14) |
May
(22) |
Jun
(40) |
Jul
(48) |
Aug
(7) |
Sep
(34) |
Oct
(31) |
Nov
|
Dec
(30) |
| 2009 |
Jan
(9) |
Feb
(6) |
Mar
(9) |
Apr
(2) |
May
(9) |
Jun
|
Jul
(31) |
Aug
(32) |
Sep
(15) |
Oct
(23) |
Nov
|
Dec
(9) |
| 2010 |
Jan
(19) |
Feb
(9) |
Mar
|
Apr
|
May
(9) |
Jun
(6) |
Jul
(8) |
Aug
(21) |
Sep
(10) |
Oct
(1) |
Nov
(3) |
Dec
(33) |
| 2011 |
Jan
|
Feb
(1) |
Mar
(4) |
Apr
(10) |
May
|
Jun
(9) |
Jul
(23) |
Aug
(2) |
Sep
(35) |
Oct
(36) |
Nov
|
Dec
(4) |
| 2012 |
Jan
(3) |
Feb
(8) |
Mar
(3) |
Apr
|
May
|
Jun
(5) |
Jul
|
Aug
|
Sep
|
Oct
(12) |
Nov
(12) |
Dec
|
| 2013 |
Jan
(18) |
Feb
(5) |
Mar
(1) |
Apr
|
May
|
Jun
(5) |
Jul
|
Aug
(21) |
Sep
|
Oct
(5) |
Nov
(1) |
Dec
(11) |
| 2014 |
Jan
|
Feb
|
Mar
(4) |
Apr
(2) |
May
|
Jun
|
Jul
(2) |
Aug
(5) |
Sep
(6) |
Oct
|
Nov
(29) |
Dec
|
| 2015 |
Jan
|
Feb
|
Mar
(14) |
Apr
|
May
|
Jun
|
Jul
(7) |
Aug
(7) |
Sep
(5) |
Oct
|
Nov
(6) |
Dec
(3) |
| 2016 |
Jan
(14) |
Feb
(9) |
Mar
(33) |
Apr
(12) |
May
(18) |
Jun
(3) |
Jul
|
Aug
(15) |
Sep
|
Oct
|
Nov
|
Dec
(22) |
| 2017 |
Jan
|
Feb
|
Mar
|
Apr
|
May
(10) |
Jun
|
Jul
|
Aug
|
Sep
|
Oct
(44) |
Nov
(32) |
Dec
(8) |
| 2018 |
Jan
(2) |
Feb
(25) |
Mar
(16) |
Apr
(11) |
May
(1) |
Jun
(19) |
Jul
(3) |
Aug
|
Sep
|
Oct
(25) |
Nov
|
Dec
|
| 2019 |
Jan
|
Feb
(2) |
Mar
|
Apr
(1) |
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
(2) |
Dec
(3) |
| 2020 |
Jan
(29) |
Feb
(28) |
Mar
(13) |
Apr
(13) |
May
(107) |
Jun
(75) |
Jul
(57) |
Aug
(36) |
Sep
(3) |
Oct
(4) |
Nov
(4) |
Dec
(1) |
| 2021 |
Jan
(2) |
Feb
(13) |
Mar
(5) |
Apr
(6) |
May
(44) |
Jun
(9) |
Jul
(9) |
Aug
(3) |
Sep
(11) |
Oct
(5) |
Nov
(14) |
Dec
(19) |
| 2022 |
Jan
(1) |
Feb
|
Mar
|
Apr
(4) |
May
(1) |
Jun
(1) |
Jul
(13) |
Aug
(6) |
Sep
(2) |
Oct
(7) |
Nov
(2) |
Dec
|
| 2023 |
Jan
(2) |
Feb
|
Mar
(13) |
Apr
(2) |
May
(31) |
Jun
(12) |
Jul
(5) |
Aug
(5) |
Sep
(27) |
Oct
(7) |
Nov
(25) |
Dec
(7) |
| 2024 |
Jan
(11) |
Feb
(27) |
Mar
(3) |
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
|
From: Köditz, M. <Mar...@it...> - 2020-05-26 13:15:07
|
Hi Mark, I'd like to update the German docs. What do I have to do? Regards Martin |
|
From: Mark R. <ma...@la...> - 2020-05-25 19:53:14
|
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 |
|
From: Paul V. <pa...@vi...> - 2020-05-25 18:35:10
|
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 |
|
From: Mark R. <ma...@la...> - 2020-05-25 18:13:23
|
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 |
|
From: Mark R. <no...@gi...> - 2020-05-25 18:11:45
|
Branch: refs/heads/master Home: https://github.com/FirebirdSQL/firebird-documentation Commit: ea5121fc815a16f65d2a83d833866f1588249793 https://github.com/FirebirdSQL/firebird-documentation/commit/ea5121fc815a16f65d2a83d833866f1588249793 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-25 (Mon, 25 May 2020) Changed paths: M build.gradle Log Message: ----------- Optimize PDF for screen instead of prepress |
|
From: Mark R. <ma...@la...> - 2020-05-25 18:10:34
|
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 |
|
From: Dmitry Y. <fir...@ya...> - 2020-05-25 17:48:36
|
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 |
|
From: Paul V. <pa...@vi...> - 2020-05-25 17:33:51
|
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 |
|
From: Mark R. <ma...@la...> - 2020-05-25 13:51:39
|
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 |
|
From: Paul V. <pa...@vi...> - 2020-05-25 12:35:23
|
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 |
|
From: Mark R. <no...@gi...> - 2020-05-23 15:14:49
|
Branch: refs/heads/master Home: https://github.com/FirebirdSQL/firebird-documentation Commit: 78619240294855caf31e32a945464fb56935db49 https://github.com/FirebirdSQL/firebird-documentation/commit/78619240294855caf31e32a945464fb56935db49 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M .gitattributes M src/theme/firebird-html/firebird.css Log Message: ----------- Add URL import for fonts Ensure css is loaded with lf to prevent unnecessary linebreaks in generated HTML Commit: ec0548db07a09163a540e56483358efe01eef5ff https://github.com/FirebirdSQL/firebird-documentation/commit/ec0548db07a09163a540e56483358efe01eef5ff Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M src/docs/asciidoc/en/firebirddocs/docwritehowto/firebird-docwriting-guide.adoc Log Message: ----------- Removed caution from chapter on publishing about being outdated Compare: https://github.com/FirebirdSQL/firebird-documentation/compare/c215b101a259...ec0548db07a0 |
|
From: Mark R. <no...@gi...> - 2020-05-23 13:57:38
|
Branch: refs/heads/master Home: https://github.com/FirebirdSQL/firebird-documentation Commit: 366b3389e1f885804b082f021443ec7f4bf86efd https://github.com/FirebirdSQL/firebird-documentation/commit/366b3389e1f885804b082f021443ec7f4bf86efd Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: A src/docs/asciidoc/fb-docs-redirects.txt Log Message: ----------- Add file with redirects for the documentation Commit: 5076785e40dfc984d7ba42bb7cfd56e08307f3f1 https://github.com/FirebirdSQL/firebird-documentation/commit/5076785e40dfc984d7ba42bb7cfd56e08307f3f1 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M src/docs/asciidoc/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.adoc M src/docs/asciidoc/en/firebirddocs/docwritehowto/firebird-docwriting-guide.adoc Log Message: ----------- Update links to point to new docs Commit: c215b101a2592adcf6d40ed0e246e62d7a58e46b https://github.com/FirebirdSQL/firebird-documentation/commit/c215b101a2592adcf6d40ed0e246e62d7a58e46b Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M src/theme/firebird-pdf/firebird-theme.yml A src/theme/firebird-pdf/images/firebird_logo_400x400.png Log Message: ----------- Copy logo into PDF theme folder Compare: https://github.com/FirebirdSQL/firebird-documentation/compare/18a0a0557c9a...c215b101a259 |
|
From: Mark R. <ma...@la...> - 2020-05-23 12:32:17
|
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 |
|
From: Mark R. <ma...@la...> - 2020-05-23 12:30:32
|
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 |
|
From: Mark R. <no...@gi...> - 2020-05-23 12:15:35
|
Branch: refs/heads/master Home: https://github.com/FirebirdSQL/firebird-documentation Commit: ef38b574f35876871eb649ffb3ab4a62f13c3de4 https://github.com/FirebirdSQL/firebird-documentation/commit/ef38b574f35876871eb649ffb3ab4a62f13c3de4 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-03 (Sun, 03 May 2020) Changed paths: M build.gradle A src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Setup basic tasks to generate documentation from asciidoc Start documenting migration. Commit: f2f8436ff7e2b88a022c3409bf2c75c28dbfa8fb https://github.com/FirebirdSQL/firebird-documentation/commit/f2f8436ff7e2b88a022c3409bf2c75c28dbfa8fb Author: Mark Rotteveel <ma...@la...> Date: 2020-05-03 (Sun, 03 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document fixes Commit: 348963487e0d01d77ada6bf6f040e32c841066a5 https://github.com/FirebirdSQL/firebird-documentation/commit/348963487e0d01d77ada6bf6f040e32c841066a5 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-03 (Sun, 03 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document some more fixes and gotchas Commit: 1087460d33d5006c07b5196aa43680d3c05d5a86 https://github.com/FirebirdSQL/firebird-documentation/commit/1087460d33d5006c07b5196aa43680d3c05d5a86 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-03 (Sun, 03 May 2020) Changed paths: M build.gradle Log Message: ----------- Ensure relative includes work properly Commit: 653373334b2e5527b705002f0fb229a485c28ed1 https://github.com/FirebirdSQL/firebird-documentation/commit/653373334b2e5527b705002f0fb229a485c28ed1 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-03 (Sun, 03 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- More gotcha's and questions Commit: 22c92db0dc4dbcf3e54629cc607abecd5492bcfe https://github.com/FirebirdSQL/firebird-documentation/commit/22c92db0dc4dbcf3e54629cc607abecd5492bcfe Author: Mark Rotteveel <ma...@la...> Date: 2020-05-03 (Sun, 03 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document some more issues and fixes Commit: 699e6fe2c52966379a792656143b572ef17a1371 https://github.com/FirebirdSQL/firebird-documentation/commit/699e6fe2c52966379a792656143b572ef17a1371 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-08 (Fri, 08 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document issues with literal inside quote Commit: f5793016d87ab0ce3680bf25e1e81cdf6b875f9b https://github.com/FirebirdSQL/firebird-documentation/commit/f5793016d87ab0ce3680bf25e1e81cdf6b875f9b Author: Mark Rotteveel <ma...@la...> Date: 2020-05-09 (Sat, 09 May 2020) Changed paths: M build.gradle A src/docs/asciidoc/en/docinfo-header.html A src/theme/firebird-html/README.md A src/theme/firebird-html/firebird.css A src/theme/firebird-pdf/firebird-theme.yml Log Message: ----------- Add theming to be more like old documentation style Commit: 538ddb33526333620589bc923be75cd65ed77fe0 https://github.com/FirebirdSQL/firebird-documentation/commit/538ddb33526333620589bc923be75cd65ed77fe0 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-09 (Sat, 09 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document fixes Commit: c06f5d8f840b0b76361ef4b3576681f1d9ac5e78 https://github.com/FirebirdSQL/firebird-documentation/commit/c06f5d8f840b0b76361ef4b3576681f1d9ac5e78 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-10 (Sun, 10 May 2020) Changed paths: M build.gradle M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc R src/docs/asciidoc/en/docinfo-header.html A src/theme/firebird-html/docinfo/docinfo-footer.html A src/theme/firebird-html/docinfo/docinfo-header.html A src/theme/firebird-html/docinfo/images/firebirdlogo.png A src/theme/firebird-html/docinfo/images/titleblackgill.gif M src/theme/firebird-html/firebird.css Log Message: ----------- Tweak HTML style + enable PDF compression Include tocbot to generate TOC that follows current position in document, and expands automatically so a deeper toc is available, but still being compact Commit: 5b55adafe454c7da8986ee8ae8182725f5d323cf https://github.com/FirebirdSQL/firebird-documentation/commit/5b55adafe454c7da8986ee8ae8182725f5d323cf Author: Mark Rotteveel <ma...@la...> Date: 2020-05-10 (Sun, 10 May 2020) Changed paths: M build.gradle Log Message: ----------- Generate TOC 3 deep for PDF Commit: 3809d8ffa28989cd2f5c0b4775a5740dae570756 https://github.com/FirebirdSQL/firebird-documentation/commit/3809d8ffa28989cd2f5c0b4775a5740dae570756 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-16 (Sat, 16 May 2020) Changed paths: M build.gradle A src/docs/asciidoc/en/asciidoc-migration/conventions-firebird-asciidoc.adoc M src/theme/firebird-html/docinfo/docinfo-header.html Log Message: ----------- Document conventions for documentation Fix image locations Commit: 36a67317e9f5cad7834ca8aaedcac9d56aa88761 https://github.com/FirebirdSQL/firebird-documentation/commit/36a67317e9f5cad7834ca8aaedcac9d56aa88761 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-16 (Sat, 16 May 2020) Changed paths: M build.gradle M buildSrc/build.gradle M buildSrc/src/main/groovy/org/firebirdsql/documentation/DocConfigExtension.groovy A buildSrc/src/main/groovy/org/firebirdsql/documentation/asciidoc/AsciidocConfig.groovy A buildSrc/src/main/groovy/org/firebirdsql/documentation/asciidoc/FbAsciidocHtmlTask.groovy A buildSrc/src/main/groovy/org/firebirdsql/documentation/asciidoc/FbAsciidocPdfTask.groovy M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc M src/docs/asciidoc/en/asciidoc-migration/conventions-firebird-asciidoc.adoc Log Message: ----------- Create custom task to be able to build per set or specific document Commit: ff67dd09f732882b5922563bd31829b7341ba2ed https://github.com/FirebirdSQL/firebird-documentation/commit/ff67dd09f732882b5922563bd31829b7341ba2ed Author: Mark Rotteveel <ma...@la...> Date: 2020-05-16 (Sat, 16 May 2020) Changed paths: M src/theme/firebird-html/firebird.css M src/theme/firebird-pdf/firebird-theme.yml Log Message: ----------- Tweak styles Commit: 838c3461fdb6e097027d27ff8e39c3aa389bd2c6 https://github.com/FirebirdSQL/firebird-documentation/commit/838c3461fdb6e097027d27ff8e39c3aa389bd2c6 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-16 (Sat, 16 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document issue with relative column widths Commit: 1820104f18914a7793943f881038c523d59ea7c4 https://github.com/FirebirdSQL/firebird-documentation/commit/1820104f18914a7793943f881038c523d59ea7c4 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-18 (Mon, 18 May 2020) Changed paths: M src/theme/firebird-html/firebird.css Log Message: ----------- Remove transition effect from tocbot .is-collapsible Commit: 2297295d7d5727d9ebb098cb88583b2d8e6598f7 https://github.com/FirebirdSQL/firebird-documentation/commit/2297295d7d5727d9ebb098cb88583b2d8e6598f7 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-19 (Tue, 19 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/conventions-firebird-asciidoc.adoc Log Message: ----------- Add note on toc macro, and add links to asciidoctor docs Commit: abddf620605406ce85b05cd9b9f0c070500b59e3 https://github.com/FirebirdSQL/firebird-documentation/commit/abddf620605406ce85b05cd9b9f0c070500b59e3 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-19 (Tue, 19 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document sgmltag fix Commit: b17d9cfc54edad3886fa78e35538377be895be6b https://github.com/FirebirdSQL/firebird-documentation/commit/b17d9cfc54edad3886fa78e35538377be895be6b Author: Mark Rotteveel <ma...@la...> Date: 2020-05-20 (Wed, 20 May 2020) Changed paths: A src/docs/asciidoc/en/firebirddocs/docbuildhowto/docbuildhowto.adoc A src/docs/asciidoc/en/images/firebirddocs/docbuildhowto/bigspace.png R src/docs/firebirddocs/docbuilding-howto.xml M src/docs/firebirddocs/fb-docwriters-info.xml R src/docs/firebirddocs/images/bigspace.png Log Message: ----------- Migrate docbuildhowto to asciidoctor Commit: 738cf0a4ff0dcec4785b6b0a690d7d313451746b https://github.com/FirebirdSQL/firebird-documentation/commit/738cf0a4ff0dcec4785b6b0a690d7d313451746b Author: Mark Rotteveel <ma...@la...> Date: 2020-05-20 (Wed, 20 May 2020) Changed paths: M src/docs/asciidoc/en/firebirddocs/docbuildhowto/docbuildhowto.adoc Log Message: ----------- Added instructions for asciidoc tasks and some copy editing Commit: 077a08479746a1eb630eca0f715a286051dc4df0 https://github.com/FirebirdSQL/firebird-documentation/commit/077a08479746a1eb630eca0f715a286051dc4df0 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-21 (Thu, 21 May 2020) Changed paths: M src/docs/asciidoc/en/firebirddocs/docbuildhowto/docbuildhowto.adoc Log Message: ----------- Fix conversion of <sgmltag class="starttag"> Commit: a5e96fedcbfc66cbe15e88810ac7e557c931e877 https://github.com/FirebirdSQL/firebird-documentation/commit/a5e96fedcbfc66cbe15e88810ac7e557c931e877 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-21 (Thu, 21 May 2020) Changed paths: M src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc Log Message: ----------- Document issues with sgmltag and html-style tables Commit: 8ab1967b57907f77b249a4f214747eb10a43a35b https://github.com/FirebirdSQL/firebird-documentation/commit/8ab1967b57907f77b249a4f214747eb10a43a35b Author: Mark Rotteveel <ma...@la...> Date: 2020-05-21 (Thu, 21 May 2020) Changed paths: A src/docs/asciidoc/en/firebirddocs/docwritehowto/firebird-docwriting-guide.adoc R src/docs/firebirddocs/docwriting-howto.xml M src/docs/firebirddocs/fb-docwriters-info.xml Log Message: ----------- Migrate docwriting-howto.xml to asciidoc Commit: 19e9cbe47fd68bfd57e996548bd9033d16810f15 https://github.com/FirebirdSQL/firebird-documentation/commit/19e9cbe47fd68bfd57e996548bd9033d16810f15 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-21 (Thu, 21 May 2020) Changed paths: R src/docs/asciidoc/en/firebirddocs/docbuildhowto/docbuildhowto.adoc A src/docs/asciidoc/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.adoc Log Message: ----------- Rename file to more suitable name (derived from old PDF) Commit: e826bba5c67ef2c9ad4f02b1ee06d5ee61293ee8 https://github.com/FirebirdSQL/firebird-documentation/commit/e826bba5c67ef2c9ad4f02b1ee06d5ee61293ee8 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: R src/docs/asciidoc/en/asciidoc-migration/conventions-firebird-asciidoc.adoc M src/docs/asciidoc/en/firebirddocs/docwritehowto/firebird-docwriting-guide.adoc Log Message: ----------- Updated firebird-docwriting-guide.adoc to include AsciiDoc info Integrated conventions-firebird-asciidoc.adoc into firebird-docwriting-guide.adoc Commit: e0be0e1abe72ab56452ed180d48947c9f30c4254 https://github.com/FirebirdSQL/firebird-documentation/commit/e0be0e1abe72ab56452ed180d48947c9f30c4254 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M src/docs/asciidoc/en/firebirddocs/docwritehowto/firebird-docwriting-guide.adoc Log Message: ----------- Update chapter Publishing your document on the Firebird website Commit: 45051c79b5a1b0fabbe996d2efd17ee34f1479b1 https://github.com/FirebirdSQL/firebird-documentation/commit/45051c79b5a1b0fabbe996d2efd17ee34f1479b1 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M src/docs/asciidoc/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.adoc Log Message: ----------- Fixed rendering issue with bare link immediately followed by a `--` generated em-dash Commit: 18a0a0557c9a8c2d472afa3c86ab84844863c692 https://github.com/FirebirdSQL/firebird-documentation/commit/18a0a0557c9a8c2d472afa3c86ab84844863c692 Author: Mark Rotteveel <ma...@la...> Date: 2020-05-23 (Sat, 23 May 2020) Changed paths: M build.gradle M buildSrc/build.gradle M buildSrc/src/main/groovy/org/firebirdsql/documentation/DocConfigExtension.groovy A buildSrc/src/main/groovy/org/firebirdsql/documentation/asciidoc/AsciidocConfig.groovy A buildSrc/src/main/groovy/org/firebirdsql/documentation/asciidoc/FbAsciidocHtmlTask.groovy A buildSrc/src/main/groovy/org/firebirdsql/documentation/asciidoc/FbAsciidocPdfTask.groovy A src/docs/asciidoc/en/asciidoc-migration/asciidoc-migration.adoc A src/docs/asciidoc/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.adoc A src/docs/asciidoc/en/firebirddocs/docwritehowto/firebird-docwriting-guide.adoc A src/docs/asciidoc/en/images/firebirddocs/docbuildhowto/bigspace.png R src/docs/firebirddocs/docbuilding-howto.xml R src/docs/firebirddocs/docwriting-howto.xml M src/docs/firebirddocs/fb-docwriters-info.xml R src/docs/firebirddocs/images/bigspace.png A src/theme/firebird-html/README.md A src/theme/firebird-html/docinfo/docinfo-footer.html A src/theme/firebird-html/docinfo/docinfo-header.html A src/theme/firebird-html/docinfo/images/firebirdlogo.png A src/theme/firebird-html/docinfo/images/titleblackgill.gif A src/theme/firebird-html/firebird.css A src/theme/firebird-pdf/firebird-theme.yml Log Message: ----------- Merge branch 'asciidoctor-init' Compare: https://github.com/FirebirdSQL/firebird-documentation/compare/2bda0f9cc668...18a0a0557c9a |
|
From: Paul V. <pa...@vi...> - 2020-05-21 20:10:58
|
Mark Rotteveel wrote: >>> I tweaked the font size a bit: >>> https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25.html >> >> The font size is exactly the same as before (I kept the screen snapshots from last week). >> I'm just talking about the main text and the nav pane here, didn't check the others. > > I didn't change the font size of the navigation pane, but there is a > difference in the size of the main body text (1em instead of 1.0625em), > compare with > https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25-oldsize.html, > or see this image: > https://www.dropbox.com/s/3ra80co6ol05e18/compare-sizes.png?dl=0 OK, I understand now. With such small differences, it depends on screen resolution and other factors whether the different point sizes translate to different on-screen pixel sizes. In my case, the letter height remains the same (11 px for caps, 8 for lower size). However, comparing fblangref25.html to fblangref25-oldsize.html, I do see that the width of some letters is 1 px less on the newer one, and letter spacing and word spacing are definitely less. (And the line spacing as well, but only marginally so: 26 px instead of 27.) On you comparison image, another font is used and I can clearly see the height difference there. So let's leave it at that! Cheers, Paul Vinkenoog |
|
From: Mark R. <ma...@la...> - 2020-05-18 15:51:51
|
On 18-05-2020 01:39, Paul Vinkenoog wrote: > Hi Mark, > >>> - Font size is rather biggish. Maybe 10% smaller or so would be better and >>> more in line with the average informative website? >> >> I tweaked the font size a bit: >> https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25.html > > The font size is exactly the same as before (I kept the screen snapshots from last week). > I'm just talking about the main text and the nav pane here, didn't check the others. I didn't change the font size of the navigation pane, but there is a difference in the size of the main body text (1em instead of 1.0625em), compare with https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25-oldsize.html, or see this image: https://www.dropbox.com/s/3ra80co6ol05e18/compare-sizes.png?dl=0 Be aware, the sources of the 'oldsize' document are not identical to the previous one as I had to recreate the asciidoc sources. There are rendering differences. For example the introduction of the first section still uses a monospace font because I didn't fix that issue, and I have removed more blockquotes than in the previous version, because I started in the wrong place to fix the cause of a rendering error, and some of the other fixes and changes I applied while experimenting are not in this version. Mark -- Mark Rotteveel |
|
From: Mark R. <ma...@la...> - 2020-05-18 14:59:25
|
On 18-05-2020 01:16, Paul Vinkenoog wrote: > Hi Mark, > >>> I see what you mean. I'll publish a variant later this week that has the >>> animation disabled. Alternatively, you could try this yourself by >>> disabling (or changing) the transition rule on #tocbot .is-collapsible. > >> Version with standard transition delay: >> https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25-stddelay.html >> >> Version without transition delay: >> https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25-nodelay.html > > I like that second one *much* better! Even if you fast-scroll with the slider (which, I admit, is > pretty pointless) it still looks good, with the nav focus just following without any up-and-down > bouncing going on. Ok, I'll remove the transition from the CSS. Mark -- Mark Rotteveel |
|
From: Norman D. <No...@du...> - 2020-05-18 11:20:42
|
Morning All, Hopefully we are all staying safe. I'm with Paul, the second version is much better. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity. |
|
From: Paul V. <pa...@vi...> - 2020-05-18 05:50:46
|
Hi Mark, > > - Font size is rather biggish. Maybe 10% smaller or so would be better and > > more in line with the average informative website? > > I tweaked the font size a bit: > https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25.html The font size is exactly the same as before (I kept the screen snapshots from last week). I'm just talking about the main text and the nav pane here, didn't check the others. Cheers, Paul |
|
From: Paul V. <pa...@vi...> - 2020-05-18 00:03:58
|
Hi all, > very good job > > both are readable very easily > > > Fabio Codebue I agree with Pavel and Fabio that the docs look much better now than they have ever done. For the first time they have a real professional look - a look that Firebird deserves. Thanks a lot for that, Mark! I know from (past) experience how incredibly time-consuming doc writing and styling are. Cheers, Paul Vinkenoog |
|
From: Paul V. <pa...@vi...> - 2020-05-17 23:57:25
|
Mark Rotteveel wrote: > > - Some of the fonts are not very pleasant to the eye (at least my eye); they > > look horizontally compressed. > I made some minor tweaks: > https://www.lawinegevaar.nl/fbdocs/pdf/en/experiment/fblangref25/fblangref25.pdf > > Specifically I changed: > - admonition captions/titles are now bold instead of italic > - text on title page is now centered Both look better now IMO. > With regard to the code font, I didn't want to spend too much time > experimenting with that now. As to the size of fonts being too big in > examples sections, that is due to the use of blockquotes, so it should > disappear once I have removed them, and otherwise we can tweak the size > further later. Agreed. I'm still having a problem with: >> - Some of the fonts are not very pleasant to the eye (at least my eye); they >> look horizontally compressed. It's the NotoSerif font. It's on the narrow side and (in my Adobe Acrobat Reader) also looks a bit unsharp. But if I'm the only one complaining about this, let's not waste any more time and just keep it. (I can always bring it up later if I find a better alternative). Cheers, Paul |
|
From: Paul V. <pa...@vi...> - 2020-05-17 23:16:55
|
Hi Mark, >> I see what you mean. I'll publish a variant later this week that has the >> animation disabled. Alternatively, you could try this yourself by >> disabling (or changing) the transition rule on #tocbot .is-collapsible. > Version with standard transition delay: > https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25-stddelay.html > > Version without transition delay: > https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25-nodelay.html I like that second one *much* better! Even if you fast-scroll with the slider (which, I admit, is pretty pointless) it still looks good, with the nav focus just following without any up-and-down bouncing going on. My 2 cts. Paul Vinkenoog |
|
From: P-Soft - F. C. <f.c...@p-...> - 2020-05-17 16:10:30
|
very good job both are readable very easily Fabio Codebue P-SOFT di Codebue Fabio Via Nuova n. 9 - 24060 Tavernola B.sca (BG) P.I. 03624950162 C.F. CDBFBA72A11C618T Mobile: +39.348.3515786 Fax: +39.030.5100306 Web: http://www.p-soft.biz <http://www.p-soft.biz/> pec: amm...@pe... cod.intermediario SDI: KRRH6B9 ------ Messaggio originale ------ Da: "Mark Rotteveel" <ma...@la...> A: fir...@li... Inviato: 16/05/2020 14:51:21 Oggetto: Re: [Firebird-docs] Example of new documentation >On 10-05-2020 14:22, Paul Vinkenoog wrote: >>Mark Rotteveel wrote: >> >>>I have published an PDF and HTML version of the Firebird 2.5 Language >>>Reference built from asciidoc. I have used some elements of style from >>>the old documentation, but a lot of it is based on the standard asciidoc >>>styles. >>> >>>Could you look at the overall style of things to see if there are things >>>you really don't like. >>> >>>https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25.html >> >>First impressions of the HTML (after 1-2 minutes of reading and scrolling): >> >>- Font size is rather biggish. Maybe 10% smaller or so would be better and >>more in line with the average informative website? > >I tweaked the font size a bit: >https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25.html > >Mark >-- Mark Rotteveel > > >_______________________________________________ >Firebird-docs mailing list >Fir...@li... >https://lists.sourceforge.net/lists/listinfo/firebird-docs |
|
From: Pavel C. <pc...@ib...> - 2020-05-17 15:23:54
|
Mark, both versions now looks awesome, at least it's pleasure for my eyes to read it. thanks Pavel Cisar IBPhoenix |
58 messages has been excluded from this view by a project administrator.
