On 2013.07.15. 6:58, Hiroki Sato wrote:
ga> The semantics of a title could be defined like a plain text title and
ga> that would be a valid semantics, too. True, it is also possible to
ga> solve it when rendering but if we decide that we don't want such in
ga> titles, why not just changing the se
On 2013.07.14. 20:57, Warren Block wrote:
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
I find different fonts for filenames and commands to be useful, even
in titles. The O'Reilly style guide doesn't mention anything about
title styles, and in a quick search I did not find anything else.
Ok, it
Gabor Kovesdan wrote
in <51e2ea74.9070...@freebsd.org>:
ga> >> It breaks the list. It is even worse in PDF rendering since there are
ga> >> page boundaries and it breaks the page up to two parts.
ga> >
ga> > I see what you mean. But if we say "don't use admonitions in lists
ga> > because they
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
I find different fonts for filenames and commands to be useful, even in
titles. The O'Reilly style guide doesn't mention anything about title
styles, and in a quick search I did not find anything else.
Ok, it doesn't specify it explicitly but can you
On 2013.07.14. 18:02, Warren Block wrote:
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
Em 14-07-2013 14:52, Warren Block escreveu:
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in
lists and such places. I think we sho
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
Em 14-07-2013 14:52, Warren Block escreveu:
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists and
such places. I think we should add a policy to avoid them and start
c
Em 14-07-2013 14:52, Warren Block escreveu:
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists
and such places. I think we should add a policy to avoid them and
start changing the markup.
Admonitions are overuse
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists and such
places. I think we should add a policy to avoid them and start changing the
markup.
Admonitions are overused in some places. They are visually jarring,
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists and
such places. I think we should add a policy to avoid them and start
changing the markup.
- We extensively use markup in titles, which later renders with a
different font. E.g. we mark the X of 9.X as r
>>> One more thing to discuss: shall we maintain the sect1, sect2, ...
>>> elements
>>> or just use section? The section element can have another section element
>>> embedded and the numbering in the rendered version is inferred by the
>>> level
>>> of embedment. This is more uniform and less redun
Em 09-07-2013 20:49, Warren Block escreveu:
The DocBook 5 book shows both forms. Converting to would be
just a search and replace. Do we need to pick one method before the
DockBook 5 version merge?
No, it's true, we can also change that later.
Gabor
Em 10-07-2013 00:10, Eitan Adler escreveu:
top posting, really?
>On Wed, Jul 3, 2013 at 3:56 AM, Gabor Kovesdan
>>One more thing to discuss: shall we maintain the sect1, sect2, ... elements
>>or just use section?
How would this be rendered in HTML? Does this change anything?
As already men
On Wed, Jul 3, 2013 at 10:40 AM, Alberto Mijares wrote:
> IMHO, is a good thing to keep a visual clue of the level you are going
> down while writing. So, should be kept, I think.
top posting, really?
> On Wed, Jul 3, 2013 at 3:56 AM, Gabor Kovesdan
>> One more thing to discuss: shall we main
On Wed, 3 Jul 2013, Alberto Mijares wrote:
On Wed, Jul 3, 2013 at 3:56 AM, Gabor Kovesdan wrote:
Em 24-05-2013 19:35, Gabor Kovesdan escreveu:
I'm working on upgrading our documentation set to DocBook 5.0 and I'd like
to discuss some details. We have some customizations and strange uses, whic
IMHO, is a good thing to keep a visual clue of the level you are going
down while writing. So, should be kept, I think.
Regards
Alberto Mijares
On Wed, Jul 3, 2013 at 3:56 AM, Gabor Kovesdan wrote:
> Em 24-05-2013 19:35, Gabor Kovesdan escreveu:
>>
>> I'm working on upgrading our documentatio
Em 24-05-2013 19:35, Gabor Kovesdan escreveu:
I'm working on upgrading our documentation set to DocBook 5.0 and I'd
like to discuss some details. We have some customizations and strange
uses, which can be expressed with DocBook 5.0's own vocabulary. This
upgrade is a good opportunity to change
Em 17-06-2013 22:05, Dru Lavigne escreveu:
Can we have a summary for the FDP (and for the benefit of Handbook editors) of
when/if systemitem class= should be used? Are there also systemitems for the
different types of s which should be used instead?
The systemitem element is documented well he
ga> Em 05-06-2013 14:10, Hiroki Sato escreveu:
ga> > Gabor Kovesdan wrote
ga> >in <519FA4FE.4030305 at FreeBSD.org>:
ga> >
ga> > ga> username --> systemitem class="username"
ga> > ga> groupname --> systemitem class="groupname"
ga> > ga> hostid role="fqdn" --> systemitem class="fqdomainname"
ga
Gabor Kovesdan wrote
in <51af556a.40...@freebsd.org>:
ga> Em 05-06-2013 14:10, Hiroki Sato escreveu:
ga> > Gabor Kovesdan wrote
ga> >in <519fa4fe.4030...@freebsd.org>:
ga> >
ga> > ga> username --> systemitem class="username"
ga> > ga> groupname --> systemitem class="groupname"
ga> > ga> ho
Em 05-06-2013 14:10, Hiroki Sato escreveu:
Gabor Kovesdan wrote
in <519fa4fe.4030...@freebsd.org>:
ga> username --> systemitem class="username"
ga> groupname --> systemitem class="groupname"
ga> hostid role="fqdn" --> systemitem class="fqdomainname"
ga> hostid role="hostname" --> systemitem
Gabor Kovesdan wrote
in <519fa4fe.4030...@freebsd.org>:
ga> username --> systemitem class="username"
ga> groupname --> systemitem class="groupname"
ga> hostid role="fqdn" --> systemitem class="fqdomainname"
ga> hostid role="hostname" --> systemitem class="fqdomainname"
ga> hostid role="domainna
Em 28-05-2013 23:06, Gabor Kovesdan escreveu:
I have a patch to preview how it would look like:
http://kovesdan.org/patches/fbsd-docbook5.diff
Please comment on this. It is very important to discuss this kind of
changes.
There are three more changes I would like to do. The maketarget and
make
On 29 May 2013 02:24, Warren Block wrote:
> On Tue, 28 May 2013, Gabor Kovesdan wrote:
>
>> I have a patch to preview how it would look like:
>> http://kovesdan.org/patches/fbsd-docbook5.diff
>>
>> Please comment on this. It is very important to discuss this kind of
>> changes.
>
>
> I think that
On Tue, 28 May 2013, Gabor Kovesdan wrote:
I have a patch to preview how it would look like:
http://kovesdan.org/patches/fbsd-docbook5.diff
Please comment on this. It is very important to discuss this kind of changes.
I think that keeping up with DocBook versions is important.
Leaving out th
Em 24-05-2013 19:35, Gabor Kovesdan escreveu:
I'm working on upgrading our documentation set to DocBook 5.0 and I'd
like to discuss some details. We have some customizations and strange
uses, which can be expressed with DocBook 5.0's own vocabulary. This
upgrade is a good opportunity to change
Hi,
I'm working on upgrading our documentation set to DocBook 5.0 and I'd
like to discuss some details. We have some customizations and strange
uses, which can be expressed with DocBook 5.0's own vocabulary. This
upgrade is a good opportunity to change these, as well. I propose the
following
26 matches
Mail list logo
