Re: [Firebird-docs] Example of new documentation

2020-05-21 Thread Paul Vinkenoog
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

Re: [Firebird-docs] Example of new documentation

2020-05-18 Thread Mark Rotteveel
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

Re: [Firebird-docs] Example of new documentation

2020-05-18 Thread Mark Rotteveel
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

Re: [Firebird-docs] Example of new documentation

2020-05-18 Thread Norman Dunbar
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.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net

Re: [Firebird-docs] Example of new documentation

2020-05-17 Thread Paul Vinkenoog
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

Re: [Firebird-docs] Example of new documentation

2020-05-17 Thread Paul Vinkenoog
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

Re: [Firebird-docs] Example of new documentation

2020-05-17 Thread Paul Vinkenoog
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

Re: [Firebird-docs] Example of new documentation

2020-05-17 Thread Paul Vinkenoog
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: >

Re: [Firebird-docs] Example of new documentation

2020-05-17 Thread P-Soft - Fabio Codebue
strazi...@pec.p-soft.biz cod.intermediario SDI: KRRH6B9 -- Messaggio originale -- Da: "Mark Rotteveel" A: firebird-docs@lists.sourceforge.net 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

Re: [Firebird-docs] Example of new documentation

2020-05-17 Thread Pavel Cisar
Mark, both versions now looks awesome, at least it's pleasure for my eyes to read it. thanks Pavel Cisar IBPhoenix ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs

Re: [Firebird-docs] Example of new documentation

2020-05-16 Thread Mark Rotteveel
On 10-05-2020 15:18, Paul Vinkenoog wrote: Mark Rotteveel wrote: 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/pdf/en/experiment/fblangref25.pdf First reaction to the PDF: - Overall, OK! - Document

Re: [Firebird-docs] Example of new documentation

2020-05-16 Thread Mark Rotteveel
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

Re: [Firebird-docs] Example of new documentation

2020-05-16 Thread Mark Rotteveel
On 10-05-2020 21:05, Mark Rotteveel wrote: 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. For comparison: Version with standard

Re: [Firebird-docs] Example of new documentation

2020-05-11 Thread Paul Vinkenoog
Mark Rotteveel wrote: > On 11-05-2020 14:30, Paul Vinkenoog wrote: > > Dmitry Yemanov wrote: > > > >> 4) I don't like how titles of / blocks are rendered, > >> they're just italic of the default size. I'd prefer a bigger font (and > >> maybe a different colour) as it was in the old version. >

Re: [Firebird-docs] Example of new documentation

2020-05-11 Thread Paul Vinkenoog
Mark Rotteveel wrote: > > Striping is evil, because it suggests that odd rows are of a different > > nature than even rows, which of course they are not. It's also totally > > unnecessary, because rows are separated by lines. > > > > Striping makes tables 'noisy' and less readable. IMO we should

Re: [Firebird-docs] Example of new documentation

2020-05-11 Thread Mark Rotteveel
On 11-05-2020 14:44, Paul Vinkenoog wrote: Mark Rotteveel wrote: However the rendering of this table is very similar in the old and new PDF docs, while in the new HTML it has striping, which it doesn't have in the old HTML. Striping is evil, because it suggests that odd rows are of a

Re: [Firebird-docs] Example of new documentation

2020-05-11 Thread Paul Vinkenoog
Mark Rotteveel wrote: > However the rendering of this table is very similar in the old and new > PDF docs, while in the new HTML it has striping, which it doesn't have > in the old HTML. Striping is evil, because it suggests that odd rows are of a different nature than even rows, which of course

Re: [Firebird-docs] Example of new documentation

2020-05-11 Thread Paul Vinkenoog
Dmitry Yemanov wrote: > 4) I don't like how titles of / blocks are rendered, > they're just italic of the default size. I'd prefer a bigger font (and > maybe a different colour) as it was in the old version. I don't think it looks good if notes, warnings and the like have a bigger font than

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 20:43, Paul Vinkenoog wrote: Mark Rotteveel wrote: [PDF]: Be aware that some tables are currently a bit mangled (both in spacing, and in some cases having wrong number of columns), which might make this look worse than normal. I'll see if I can clean it up, but that might be

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 20:21, Paul Vinkenoog wrote: Mart Rotteveel wrote: - Font size is rather biggish. Maybe 10% smaller or so would be better and more in line with the average informative website? The font size is based on the default font size in your browser settings. Would changing that setting

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Paul Vinkenoog
Mark Rotteveel wrote: [PDF]: > > - In tables, sometimes the first column is centered and the second one > > left-justified; sometimes the first is right-justified and the second > > left-justiified. > > I know this is already the case in the existing LangRef, but I find it > > absolutely > >

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Paul Vinkenoog
Mart Rotteveel wrote: > > 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? > > The font size is based on the default font size in

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 15:18, Paul Vinkenoog wrote: - In tables, sometimes the first column is centered and the second one left-justified; sometimes the first is right-justified and the second left-justiified. I know this is already the case in the existing LangRef, but I find it absolutely horrible,

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 18:16, Mark Rotteveel wrote: On 10-05-2020 17:23, Dmitry Yemanov wrote: 3) Looking at Switching the Terminator in isql on page 159 inside the DDL chapter, I see that PDF is rendered with two links "Switching the Terminator in" and "isql". Looks weird. I think this is a

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 17:23, Dmitry Yemanov wrote: 10.05.2020 14:19, 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

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 15:18, Paul Vinkenoog wrote: Mark Rotteveel wrote: 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/pdf/en/experiment/fblangref25.pdf First reaction to the PDF: - Overall, OK! - Document

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
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

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Paul Vinkenoog
Mark Rotteveel wrote: > 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/pdf/en/experiment/fblangref25.pdf First reaction to the PDF: - Overall, OK! - Document title and author listing: really don't like

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
On 10-05-2020 13:38, Денис Симонов via Firebird-docs wrote: Descriptions of parameters, for example, Table 17. CREATE SHADOW Statement Parameters. The parameter should not be centered. It looks bad. In the current documentation it is also centered. The difference is that in the new HTML

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Paul Vinkenoog
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

Re: [Firebird-docs] Example of new documentation

2020-05-10 Thread Денис Симонов via Firebird-docs
  >Воскресенье, 10 мая 2020, 14:20 +03:00 от Mark Rotteveel >: >  >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. >

[Firebird-docs] Example of new documentation

2020-05-10 Thread Mark Rotteveel
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