Editing Best Practices (to avoid release errors)
Always use Relative Wiki Links!
When entering in links to other pages in this wiki, never use the Full Harcoded Link. Instead, always use a relative link!
For example, if you wanted to link to the Configuration page:
Harcoded Link (BAD!) |
https://wiki.duraspace.org/display/DSDOCDEV/Configuration | ||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="b5285a3c-59f5-4b0b-a0ff-223cbe83d3a7"><ac:plain-text-body><![CDATA[ |
Relative Link (Good!) |
|
]]></ac:plain-text-body></ac:structured-macro> |
Another example! This time, of a link to a specific heading on a page. Suppose you wanted to link to the Configuration header on the Configuration page:
Harcoded Link (BAD!) |
https://wiki.duraspace.org/display/DSDOCDEV/Configuration#Configuration-BatchMetadataEditing | ||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="17407ac0-5561-4494-bd79-1807dca12559"><ac:plain-text-body><![CDATA[ |
Relative Link (Good!) |
|
]]></ac:plain-text-body></ac:structured-macro> |
One final example. It's the same as the above "Batch Metadata Editing" example, but now we are changing the text in the link to say "Batch Metadata Editing Configuration"
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a1e92dd1-2995-4fcc-8380-2f0a15c2d2d1"><ac:plain-text-body><![CDATA[ |
Harcoded Link (BAD!) |
[Batch Metadata Editing Configuration|https://wiki.duraspace.org/display/DSDOCDEV/Configuration#Configuration-BatchMetadataEditing] |
]]></ac:plain-text-body></ac:structured-macro> |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="0a3c6a36-aeac-4491-b6db-ce6d16151379"><ac:plain-text-body><![CDATA[ |
Relative Link (Good!) |
|
]]></ac:plain-text-body></ac:structured-macro> |
You can view the source of this page for examples