OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

legalxml-courtfiling-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: FW: [chairs] From the TAB: crucial tip about hyperlinks versus cross-references


FYI.  I’ll update our use of cross-references to the recommended approach in the next working draft.

 

__
Jim Cabral
502 509-4532

 

From: Chet Ensign
Sent: Wednesday, August 2, 2017 4:23 PM
To: chairs@lists.oasis-open.org
Cc: OASIS TAB; Paul Knight
Subject: [chairs] From the TAB: crucial tip about hyperlinks versus cross-references

 

TC chairs, 

 

Please share this with your editors as needed. 

 

The TAB is busy producing a handbook for OASIS spec editors with the goal of providing practical advice to help them get specs together efficiently. 

 

However, we identified one tip that, because it is so black and white, we wanted to get out immediately. 

 

When creating links in Word or Open Office, whether intra-document or inter-document, do not use the cross-reference feature. Use hyperlinks to bookmarks you have set instead. 

 

The reason for this is that we've realized that while cross-references work fine in the tool, when we save your spec as PDF or HTML, the cross-reference links are not saved. We have encountered this in some documents lately and we haven't found a way to fix it.

 

Bookmarks work even though they take more effort on your part. Mark any text that you want to act as a link target as a bookmark using your editing tool. (E.g. highlight the text and select Insert / Bookmark.) 

 

Then, use Insert / Hyperlink, select the document and select the bookmark. 

 

We have never encountered problems with links done this way even where the editors have constructed complex links to different directories, etc. 

 

If anyone knows of a method for making cross-references work, please let us know. Meanwhile, to ensure that your links work in all cases, use Bookmarks and Hyperlinks. 

 

As always, let us know if you have any questions. 

 

--


/chet 
----------------
Chair - OASIS TAB

 

Jacques Durand, Fujitsu

Patrick Durusau, Individual member

Ashok Malhotra, Individual member

Kevin Mangold, NIST 

Stefan Hagen, Individual member

 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]