Synopsis: [handbook] callouts appear to be broken, failing to render
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Tue Mar 25 07:05:19 UTC 2014
State-Changed-Why:
I have reverted the changes that broke inline formatting in verbatim text.
Thanks for y
Hey,
On Wed, Feb 5, 2014 at 8:25 AM, Hiroki Sato wrote:
> Please welcome Warren Block as a new doceng
> member.
That is excellent news! Congratulations, Warren, I am sure you deserve this.
___
freebsd-doc@freebsd.org mailing list
http://lists.freeb
columns do not fit?
I believe that a collapsible tree list would be the best option but that
requires JavaScript, which we prefer to avoid...
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubsc
ot;page", something that would
work for large an small screen users.
As you state here, the list is already so long, that's exactly why
subsections are not included...
The individual sections of the Handbook use the full horizontal
"page", why not the TOC?
W
thread by you will go unanswered by me for I will not
lower myself to your level.
Where's your signature? If it is really a frank opinion, why don't you
sign it with your real name?
Gabor Kovesdan
___
freebsd-doc@freebsd.org mailing
Synopsis: [handbook] Expand handbook Table of contents
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 14:37:11 UTC 2014
State-Changed-Why:
Currently, the TOC has three levels: part, chapter and section. I am afraid
that expanding more levels would
Synopsis: Translation of dashes in PDF version
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 14:35:12 UTC 2014
State-Changed-Why:
Fixed, thanks!
Responsible-Changed-From-To: freebsd-doc->gabor
Responsible-Changed-By: gabor
Responsible-Change
Synopsis: *** [article.html] Error code 1 Stop in /usr/doc.
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 13:56:32 UTC 2014
State-Changed-Why:
Please update your doc tree, install textproc/docproj and try again. If you
still experience troubles,
Synopsis: Missing parts after rendering handbook to RTF format
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 13:39:19 UTC 2014
State-Changed-Why:
We now a use a more mature toolchain so fixrtf is not used any more.
Anyway, thank you for your rep
Synopsis: Bug in PDF DocBook rendering
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 13:37:03 UTC 2014
State-Changed-Why:
We now use a different toolchain, which handles better running off text.
If there are such parts in the documentation, th
Synopsis: [patch] to doc.docbook.mk to post process .tex files.
State-Changed-From-To: suspended->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 13:35:51 UTC 2014
State-Changed-Why:
We do not use TeX any more in the rendering process. Thanks for your
contribution, tho
Synopsis: HTML rendering: replaceable elements are not distinguished
State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 10:28:17 UTC 2014
State-Changed-Why:
I have fixed this case, thanks! Unfortunately, some other replaceable elements
may have been l
On Tue, Aug 20, 2013 at 10:15 PM, Gabor Kovesdan wrote:
> I've worked with Trados before (commercial CAT software) [..] I think using
> similar method
> in FreeBSD would be very practical if we can find proper open source CAT
> tools. I agree
> with Warren that we should
e markup that generates the
link is part of the entity. But entities are like variables, changing
the definition will change all occurrences and this is sometimes
useful. For example with those entities that are referring to the
current release number of the ports count,
Em 20-08-2013 19:10, Warren Block escreveu:
On Tue, 20 Aug 2013, Gabor Pali wrote:
On Tue, Aug 20, 2013 at 4:13 PM, Warren Block
wrote:
Well, yes, but this appears to be manual and does not automatically
translate the same strings that are found in other documents. That
is part
of what the
On Tue, Aug 20, 2013 at 4:13 PM, Warren Block wrote:
> Well, yes, but this appears to be manual and does not automatically
> translate the same strings that are found in other documents. That is part
> of what the newer automated systems do.
Erm, I am a bit skeptic about this as nouns (and expre
Hi Warren,
On Mon, Aug 19, 2013 at 6:07 PM, Warren Block wrote:
> * Translators work too hard. No automation, no assistance from the
> computer to see what needs to be translated
I am not sure of this. A few years ago we seem to have a consensus on
an informal "API" that allows tracking untr
also added support for dblatex, but it is more limited. The
deliverables of the overall work are:
1, A DocBook 5.0 tree of the documentation. The basic set is available
in projects/db5 but still the converter has to be run on a fresh
checkout. The converter can be obtained from user/gabor/db5 an
. I think the slush is about content change so that translators can
catch up so I personally I would not object if you wanted to do it earlier.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To
On 2013.07.29. 0:09, Warren Block wrote:
On Sun, 28 Jul 2013, Gabor Kovesdan wrote:
On 2013.07.28. 21:37, Warren Block wrote:
Line numbering is nice sometimes, although sometimes it's easy to
confuse with content. Syntax highlighting could be useful in places
like the Archite
On 2013.07.28. 22:23, Glen Barber wrote:
On Sun, Jul 28, 2013 at 10:17:50PM +0200, Gabor Kovesdan wrote:
>I believe it is possible to make them work together. But using these
>extensions requires using Saxon as the XSLT processor, which is
>Java-based and slower than xsltproc. Even if
t would be better to keep the XHTML build fast and
Java-free so that committers can easily test their work.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freeb
we may as well create an image with an SVG editor.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
On 2013.07.28. 19:45, Gabor Kovesdan wrote:
On 2013.07.28. 19:00, Warren Block wrote:
Long lines in screen and programlisting elements run off the right
side of the screen with the current CSS.
It would be great to have them wrap and include a visible a line wrap
indicator, but that may not
wrapped due to screen width.
Is there a better way to accomplish this?
This seems to work:
http://iany.me/2012/02/css-line-wrap-indicator/
The wrapping of programlisting content into span elements can be done in
XSLT.
Gabor
___
freebsd-doc@freebsd.org
thout filename tags in the
example.
Anyone care strongly either way?
I prefer the first approach. The emphasis is on what the user should
type and not on the fact that it is a filename. Besides, the green
rendering inside the userinput would be too much.
On 2013.07.24. 1:28, Warren Block wrote:
On Wed, 24 Jul 2013, Gabor Kovesdan wrote:
On 2013.07.23. 23:11, Warren Block wrote:
There is something weird about bulleted lists and sub-lists,
starting on page 35 of the PDF Handbook (page 7-9 of the content).
Some entries in the first list are
ering is still a work in progress. I'll see what I can do here.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
t overflows instead of
causing a page break. The good thing is that the output of the renderer
is very clean and we can clearly see which pages have overflows.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listin
documents, I'm still experimenting with font settings but now we are one
step closer to the goal.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
arts still need
improvements but feel free to comment on anything you think that should
be changed.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
though there are some exmaples for
such an informal title like this:
Pros:
- A
- B
Cons:
- C
- D
they are items, not "title" actually. If we really need it, it
should be a caption.
I believe these are alrea
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 anythin
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
imes by feeding
back the results to the concrete documents.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Em 10-07-2013 13:19, Warren Block escreveu:
On Wed, 10 Jul 2013, Gabor Kovesdan wrote:
Em 10-07-2013 03:36, Warren Block escreveu:
For "FreeBSD 9.2", numbers and units like "8 GB", and guibutton
uses, I think using nbsp is probably okay. For "Ports Collectio
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.
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 anythi
use it.
Seems like a good rule of thumb. I agree on version numbers and units
but what do you mean by guibutton uses? I remember of Cancel, OK and
such but do we have two-word guibuttons?
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.f
the differences and have
made it easier to read the diffs. Next time we can count with this factor.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
best
practice to avoid whitespace changes in branches.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
n htdocs fails with the
same error as above. Maybe share/xml/xhtml10-freebsd.dtd is the wrong
file to add this?
Just forgot to patch those with sed. Patch updated.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/list
mp;a.tabthorpe; tabtho...@freebsd.org
Sorry, I missed the role attribute. The namespace should have been
xmlns="". This patch seems to solve both problems and works fine:
http://kovesdan.org/patches/email-entities.diff
Gabor
___
freebsd-doc@
andles properly the email element in the default (empty) namespace.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
refixes="str"
exclude-result-prefixes="#default">
@@ -162,6 +163,27 @@
+
+
+ <
+
+
+
+
+
+
+
+ mailto:
+
+
+
+
+
+
+ >
+
+
The rest looks fine, thanks
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 opport
, The reference is often the last sentence of a paragraph, i.e. "For
further informations on foo, please refere to bar." This can be just put
into a profiled phrase.
2, Or if the reference has a longer explanatory text, it can have its
own para with a profiling att
ory, and pgpkey list from
the body in book.xml.
I believe that XHTML is an online format by nature but pdf may also be
distributed as an online snapshot after the actual release so I would
also treat them separated as Warner suggests.
Gabor
___
freeb
General advices, spelling, etc.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
used in FreeBSD's
DocBook sources. It could be a longer-term target to change to that but
for now, will do.
3. Should links to an external website use a tag, an url=, and the
description to appear? For example:
http://www.wi-fi.org/";>Wi-Fi alliance
Em 05-06-2013 14:34, Hiroki Sato escreveu:
Gabor Kovesdan wrote
in<51ab6d32.1060...@freebsd.org>:
ga> Em 02-06-2013 17:03, Warren Block escreveu:
ga> > That means "include elements marked with edition="print" and all
ga> > unprofiled elements"?
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=&q
should use phrase. If
it is a whole paragraph, you can add the markup para.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Em 02-06-2013 00:13, Warren Block escreveu:
On Sat, 1 Jun 2013, Gabor Kovesdan wrote:
Em 01-06-2013 20:52, Warren Block escreveu:
No objection from me, I just want to bring it up again that
handling these with a single-source solution would be nice, i.e.
using DocBook profiling. It would
Em 01-06-2013 20:23, Chris Rees escreveu:
I'm thinking edition="FreeBSD-7" etc. Just a thought, and it's
probably irrelevant, sorry.
Not entirely possible yet but there are plans to support this.
Gabor
___
freebsd-doc@freebsd.o
t sections. And only
need to add edition="print" to non-online sections. The rest is shared
and the markup is kept minimal.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe,
y go to the online version and those marked as edition="print" only
go to the print version. The rest is rendered in both. This also
requires setting some parameters in the Makefile and will just work.
Gabor
___
freebsd-doc@freebsd.org maili
be nice, i.e. using DocBook
profiling. It would also facilitate merges. This basically consists of
adding edition="print" to the affected section of preface and then
setting up profiling. (I can do it, just ping me if there is consensus
on this).
Gabor
_
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
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 opport
filename class attribute may
also be devicefile, which expresses its semantics. Again, we should
consider dropping the class attributes to simplify things:
devicename --> filename class="devicefile"
These are not actually distinguished in formatting and the package
element express
On 2013.05.18. 20:59, Ulrich Spörlein wrote:
On Sat, 2013-05-18 at 10:28:39 +0200, Gabor Kovesdan wrote:
>Em 18-05-2013 06:23, Ulrich Spörlein escreveu:
> >So, to get groff out of source we need to first remove the roff
> >docs/papers as we will no longer build and install them
On 2013.05.18. 13:01, Warren Block wrote:
On Fri, 17 May 2013, Gabor Kovesdan wrote:
Em 16-05-2013 12:57, Gabor Kovesdan escreveu:
I'll be merging back the XML toolchain changes to head tomorrow
around 6pm GTM. I'll temporarily lock head to avoid conflicting
changes at the same tim
ing conventions.
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Em 16-05-2013 12:57, Gabor Kovesdan escreveu:
I'll be merging back the XML toolchain changes to head tomorrow around
6pm GTM. I'll temporarily lock head to avoid conflicting changes at
the same time and head will be reopen very soon after the merge is
complete. At the same time, th
ogs
- Drop HTML Tidy since it is not needed any more
[1] http://www.sagehill.net/docbookxsl/Profiling.html
Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freeb
Em 09-05-2013 05:25, Warren Block escreveu:
On Wed, 8 May 2013, Gabor Kovesdan wrote:
I've fixed all the reported problems again. (Except those that were
already there before my work, since they are not trivial to fix in
this phase.) I've also updated the generated documentation
Em 08-05-2013 14:28, Marc Fonvieille escreveu:
On Fri, Mar 15, 2013 at 08:42:01AM +0100, Gabor Kovesdan wrote:
> >
> >Good question. I know this is given as a reason why acronyms should
> >always be marked up, and I thought I'd seen it at some point in the
> >Free
Hi,
I've fixed all the reported problems again. (Except those that were
already there before my work, since they are not trivial to fix in this
phase.) I've also updated the generated documentation set:
http://people.freebsd.org/~gabor/db45/
<http://people.freebsd.org/%7Egabor/db
Em 26-02-2013 22:56, Gabor Kovesdan escreveu:
I have some improvements for the doc infrastructures in the xml-tools
branch. I think that the changeset is now getting mature enough to be
merged back so I'd like to ask for review. It does not affect the web
pages, only books and articles
Em 15-03-2013 00:33, Warren Block escreveu:
On Thu, 14 Mar 2013, Gabor Kovesdan wrote:
Em 27-02-2013 02:24, Warren Block escreveu:
Author info is a little off. Compare the authors at the start of
the bsdinstall chapter:
http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook
Em 27-02-2013 02:24, Warren Block escreveu:
Author info is a little off. Compare the authors at the start of the
bsdinstall chapter:
http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/bsdinstall.html
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall.html
Em 03-03-2013 08:40, Simon L. B. Nielsen escreveu:
On 26 Feb 2013 21:56, "Gabor Kovesdan" <mailto:ga...@freebsd.org>> wrote:
> I have some improvements for the doc infrastructures in the
xml-tools branch. I think that the changeset is now getting mature
enough to be m
ial" should be split between
two pages.
I would also prefer having it in developers' handbook. It would be
really practical to have a single developer documentation just like
handbook for users. I think it would be a good objective to put some
ef
Em 26-02-2013 21:46, Anthony Brown escreveu:
Would enough people like a tutorial in freebsd developer handbook on
freebsd 64 bit assembly language using the c standard library.
It would be awesome! We really need more content for developer docs. I
can help out with the DocBook markup.
Gabor
http://people.freebsd.org/~gabor/db45/
For every article/book, you will find there the chunked XHTML docs or if
you manually enter the URL, you can access the single XHTML and PDF
versions as (article|book)\.(html|pdf).
The branch contains the following changes:
- Upgrade to DocBook 4.5
- Use
doc/en_US.ISO8859-1/htdocs
make all install DESTDIR=/home/gabor/public_html/webtest
2, To build documentation only (without web):
cd doc
make all install DOCDIR=/home/gabor/public_html/doc
3, Only build one specific article/book:
cd doc/en_US.ISO8859-1/article/foobar
make all install DOCDIR=/home
77 matches
Mail list logo
