X-Scanned-BY: MIMEDefang 2.68 on 10.5.11.27
MIME-Version: 1.0
In-Reply-To: <rt-3.8.6-77135-1396969864-1848.35713-5-0@isc.org>
X-Spam-Status: No, score=-7.5 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, RP_MATCHES_RCVD autolearn=ham autolearn_force=no version=3.4.0
References: <RT-Ticket-35713@isc.org> <5343D797.6070006@redhat.com> <rt-3.8.6-77135-1396960633-344.35713-5-0@isc.org> <5343EF63.5020608@redhat.com> <rt-3.8.6-32680-1396961141-630.35713-4-0@isc.org> <20140408151104.GB22724@isc.org> <rt-3.8.6-77135-1396969864-1848.35713-5-0@isc.org>
Message-ID: <53441562.90902@redhat.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Organization: Red Hat
X-RT-Original-Encoding: utf-8
Received: from mx.pao1.isc.org (mx.pao1.isc.org [149.20.64.53]) by bugs.isc.org (Postfix) with ESMTP id 7BC2D2D20051 for <bind-suggest@bugs.isc.org>; Tue,  8 Apr 2014 15:27:36 +0000 (UTC)
Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.pao1.isc.org (Postfix) with ESMTP id 06591349446 for <bind-suggest@isc.org>; Tue,  8 Apr 2014 15:27:34 +0000 (UTC) (envelope-from pspacek@redhat.com)
Received: from int-mx14.intmail.prod.int.phx2.redhat.com (int-mx14.intmail.prod.int.phx2.redhat.com [10.5.11.27]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id s38FRXev005808 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <bind-suggest@isc.org>; Tue, 8 Apr 2014 11:27:34 -0400
Received: from pspacek.brq.redhat.com (vpn1-6-167.ams2.redhat.com [10.36.6.167]) by int-mx14.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id s38FRVFg014875 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO) for <bind-suggest@isc.org>; Tue, 8 Apr 2014 11:27:32 -0400
Delivered-To: bind-suggest@bugs.isc.org
Subject: Re: [ISC-Bugs #35713] permanent href targets in HTML documentation
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.4.0
Return-Path: <pspacek@redhat.com>
X-Original-To: bind-suggest@bugs.isc.org
Date: Tue, 08 Apr 2014 17:27:30 +0200
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mx.pao1.isc.org
To: bind-suggest@isc.org
Content-Transfer-Encoding: 7bit
From: Petr Spacek <pspacek@redhat.com>
RT-Message-ID: <rt-3.8.6-32481-1396970856-924.35713-0-0@isc.org>
Content-Length: 1194

On 8.4.2014 17:11, Evan Hunt via RT wrote:
> Hi Petr,
>
> On Tue, Apr 08, 2014 at 12:45:42PM +0000, Petr Spacek via RT wrote:
>> I understand you, sure, time is always a problem.
>>
>> Maybe I can send you some patches if you are willing to accept them.
>
> The person who originally set up our documentation is no longer with
> ISC, and I haven't had time to look into the matter and find out *how*
> to put permanent human-readable anchors into the xml/docbook files and
> have them do the right thing once converted to HTML.  If you already
> know how, can you send me a sample, and save me the research effort?

Sure!

All you have to do is to define "id" attribute.

E.g.:
   <chapter id="Bv9ARM.ch01">
     <title>Introduction</title>

automatically produces metadata for link
http://ftp.isc.org/isc/bind9/cur/9.9/doc/arm/Bv9ARM.ch01.html#Bv9ARM.ch01


This works out-of-the-box for standard tags like chapter, section, example, 
table etc.


You can see more examples on
http://www.freeipa.org/docs/master/html-desktop/index.html#ex.user-search

The respective source is on
https://git.fedorahosted.org/cgit/freeipa-docs.git/tree/src/user_guide/en-US/Users.xml#n2364

-- 
Petr^2 Spacek