From stuart at elsn.org Thu Jun 4 22:08:11 2015 Content-Type: multipart/mixed; boundary="===============4386866198927860736==" MIME-Version: 1.0 From: Stuart Ellis To: docs at lists.fedoraproject.org Subject: Wiki > DocBook guidelines Date: Sun, 02 Oct 2005 18:11:22 +0100 Message-ID: <1128273082.2770.38.camel@localhost.localdomain> --===============4386866198927860736== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Page is here: http://www.fedoraproject.org/wiki/DocsProject/WritingUsingTheWiki The two issues: - Markup for , , , etc. Following the discussion in the FDSCo meeting I've currently specified monospace (backticks) for all of them. The export renders this as whatever. One advantage of monospace over italics is that it isn't used in other contexts. It also looks more like the final document. - Referencing one document section from another. For want of any better options, I'm inclined to use the name of the document section in monospace here, because it isn't ambiguous for humans. This is an issue for both single page or multiple-page documents. MoinMoin does not seem to support internal section links within a page. Links to other Wiki pages that are also part of the same document become invalid on export. For example, as Wiki: =3D=3D Understanding the Directory Structure =3D=3D yada yada ya Refer to ../ManagingStorage for details of how to attach drives and disk partitions to your filesystem. MoinMoin > DocBook conversion:
Understanding the Directory Structure yada yada ya ../ManagingStorage= Valid DocBook document: Understanding the Directory Structure yada yada ya Refer to for details of how to attach drives and disk partitions to your filesystem. -- = Stuart Ellis stuart(a)elsn.org Fedora Documentation Project: http://fedora.redhat.com/projects/docs/ GPG key ID: 7098ABEA GPG key fingerprint: 68B0 E291 FB19 C845 E60E 9569 292E E365 7098 ABEA=20 --===============4386866198927860736== Content-Type: application/pgp-signature MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="signature.asc" LS0tLS1CRUdJTiBQR1AgU0lHTkFUVVJFLS0tLS0KVmVyc2lvbjogR251UEcgdjEuNC4xIChHTlUv TGludXgpCgppRDhEQlFCRFFCUzVLUzdqWlhDWXErb1JBbG5kQUtDWEdkUER3dnp0RFNXM2ZvZDNw ei9BMk9laVFRQ2ZVdEljCnZSSzVWdTlaaGN1bXBtZUlXMldmYmVRPQo9UlEyMgotLS0tLUVORCBQ R1AgU0lHTkFUVVJFLS0tLS0K --===============4386866198927860736==--