From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 22 17:31:55 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@freebsd.org
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6E19916A429
	for <freebsd-doc@freebsd.org>; Thu, 22 Dec 2005 17:31:55 +0000 (GMT)
	(envelope-from keramida@ceid.upatras.gr)
Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.94])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A13A143D88
	for <freebsd-doc@freebsd.org>; Thu, 22 Dec 2005 17:31:08 +0000 (GMT)
	(envelope-from keramida@ceid.upatras.gr)
Received: from flame.pc (aris.bedc.ondsl.gr [62.103.39.226])
	by rosebud.otenet.gr (8.13.4/8.13.4/Debian-8) with SMTP id
	jBMHU5c4025103; Thu, 22 Dec 2005 19:30:06 +0200
Received: by flame.pc (Postfix, from userid 1001)
	id B9203118A5; Thu, 22 Dec 2005 19:28:58 +0200 (EET)
Date: Thu, 22 Dec 2005 19:28:58 +0200
From: Giorgos Keramidas <keramida@ceid.upatras.gr>
To: Joseph Koshy <joseph.koshy@gmail.com>
Message-ID: <20051222172858.GA73345@flame.pc>
References: <84dead720511150510x4a008076ie4d00129ab6b5b65@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <84dead720511150510x4a008076ie4d00129ab6b5b65@mail.gmail.com>
Cc: freebsd-doc@freebsd.org
Subject: Re: DocBook toolchain questions
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 22 Dec 2005 17:31:55 -0000

On 2005-11-15 18:40, Joseph Koshy <joseph.koshy@gmail.com> wrote:
> A couple of questions about our DocBook to PDF translation process:

Hi Joseph,

This is a relatively old post, but I'm only now catching up with
freebsd-doc email after a long period of ${REALJOB} fun.  Please
ignore any replies for which you have more definitive feedback.

> 1) Is it possible to use <olink> to refer to documentation named by
>    entities (say other documents) inside our documentation collection?
>    Using <ulink url=""> forces links to go to HTML documents.

AFAIK, no.  There is an open bug report about this: docs/27605

    http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/27605

> 2) I noticed that <ulink url=""> elements are getting rendered as
>    "TEXT" + "URL" in the PDF document.  Why don't we use PDF links
>    directly?

IIRC, this doesn't work with both jade and openjade.  I could be wrong
though.

> 3) Is is possible to render <programlisting> elements with a smaller
>    than default font?

Yes, of course.  By tweaking the stylesheet :-)