PDF version - relative links do not work

[Doug Smythies]

In the serverguide document source files, there are two relative links.

configuration.xml
<a class="ulink" href="../sample/sources.list" target="_top">Here</a>

postfix.xml
<a class="ulink" href="../sample/postfix_configuration" target="_top">this</a>.

Such links are not allowed. Why? Because they will not work in the PDF version of the document, which needs to be able to stand on its own.

They should be changed to an absolute links or deleted.

[Matthew East (mdke)]

This doesn't look like docbook, it looks like html! Internal document links should look like this:

<xref linkend="TARGET"/>

[Doug Smythies (dsmythies)]

I was not clear in my original posting.

The links are external links, not internal. Yes, it works for the final html posted at, for the 11.10 example, https://help.ubuntu.com/11.10/serverguide/C/postfix.html becasue the file https://help.ubuntu.com/11.10/serverguide/sample/postfix_configuration is posted there also.

However, in the case of the PDF, which needs to be a document on its own, the relative link is meaningless. For example, my 11.10 PDF is on a windows computer in:
C:\Users\Doug\Downloads\Ubuntu\serverguide1110.pdf
so the relative link becomes:
C:\Users\Doug\Downloads\sample\postfix_configuration
which does not exist.
However an aboloute link of https://help.ubuntu.com/11.10/serverguide/sample/postfix_configuration does exist.

[Doug Smythies (dsmythies)]

In my initial write up, I seem to have cut and pasted from HTML source (as Matthew suggested) and used incorrect files names (no good explaination why).

I'm proposing that edits be done as shown below:

File: package-management.xml:

    <para>Current:
    <ulink url="../sample/sources.list">Here</ulink> is a simple example of a typical <filename>/etc/apt/sources.list</filename> file.
    </para>

    <para>Proposed:
    <ulink url="&ubuntu-documentation;/&distro-rev-short;/serverguide/sample/sources.list">Here</ulink> is a simple example of a typical <filename>/etc/apt/sources.list</filename> file.
    </para>

File: mail.xml:

            <para>Current:
            Now, the file <filename>/etc/postfix/main.cf</filename>
            should look like <ulink url="../sample/postfix_configuration">this</ulink>.
            </para>

            <para>Proposed:
            Now, the file <filename>/etc/postfix/main.cf</filename>
            should look like <ulink url="&ubuntu-documentation;/&distro-rev-short;/serverguide/sample/postfix_configuration">this</ulink>.
            </para>

[Doug Smythies (dsmythies)]

The sources.list issue was removed in 12.10. The postfix_configuration should just be put in-line and then the entire "sample" directory, which has some obsolete stuff, should be deleted (which would also require some chnges to the Makefile).