Adding a Pretty URL in DITA - Fluid Topics - 3.6 - Technical Notes

Empower Metadata with Fluid Topics

Product
Fluid Topics
Fluid Topics Version
3.6
Category
Technical Notes
Language
English
Target Audience
public

The ft:prettyUrl metadata element is available for DITA maps and DITA topics.

When creating pretty URLs manually, colons, question marks, brackets, at signs, and percent signs are forbidden. Exclamation points, dollar signs, ampersands, apostrophes, parentheses, plus signs, commas, semicolons, and equals signs are allowed. All other non-ASCII characters are displayed as percent-encoded.

The following lines show how to assign a value for the ft:prettyUrl metadata key to a DITA map:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN"
"map.dtd"> <map xml:lang="en-US" linking="none">
<title>Oleandor Tips</title>
<topicmeta>
<othermeta name="ft:prettyUrl" content="Product/Oleandor/Tips"/>
...
</topicmeta>
...
</map>

The following lines show how to assign a value for the ft:prettyUrl metadata key to a DITA topic:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Topic//EN"
"topic.dtd"> <topic id="my-topic">
<title>Tip 1: Time Machine settings</title>
<prolog>
<metadata>
<othermeta name="ft:prettyUrl" content="Product/Oleandor/Time-Machine-Settings"/>
</metadata>
</prolog>
<body>
...
</body>
</topic>