Can you suggest example websites or public docs that use DITA and xrefs?

Specifically, ones that have cross-references to other topics and external sources.
We are embarking on the DITA-conversion adventure would like to avoid the pitfalls of the (what I hear can be a painful) transition for things like using cross-references.  Our current docs are littered with "For more info, see Blah on page 15-3" and "For more info, see www.blah.com"
Note: I don't need to see the .fm source docs yet, we are just evaluating the look and how links work at the display level.
Thx!

There is also a model for linking that is used in DITA that differs from the "random" approach that a lot of content takes. To quote you:
"Our current docs are littered with [xrefs]"
In DITA you can, technically, put links all over the place, but there is a better overall approach to consider. One is to use <related-links> which only appear at the end of a topic. This is neat, but it is still internal to the file. The other approach is to use a reltable. This is inserted in a map and used at the time of publishing to put in links.
Imagine this in a world where FM is used: You create a book, but it's made up of many nested files. If a file is at the "highest" level then it's a chapter, but if you put a file link in one more level down, it's a Heading1, and another level down is a Heading2.
Now you end up with stuff like this:
The Entire World
      Europe
           Germany
           Italy
           England
     Asia
           Japan
           China
When you publish The Entire World you get two chapters, and then have many countries in them. However, no links (yet). Instead, you just have a bunch of content combined together and published. But now you add a set of rules that say "it would be great if Japan and England link to each other". When added and you publish you get two links. One from Japan to England, the other from England to Japan. They appear after you write about the two nations, and they are inserted in the published output, but NOT inside the file. So now you can use Japan or England in a totally different context, but not have to remove the links.
If you have ever used conditions to hide xrefs because some docs are reused, but the links make no sense in another context, then DITA and Frame become a very neat combination for you. There's more to it than that, but consider how/why your links exist before you decide to convert in bulk. In some cases it is very worthwhile to do a good review of content before structuring. Actually, that should likely read "in most cases" as links are often added, but seldom removed.
Hope that helps,
Bernard

Similar Messages

  • Can you get an iphone 5 at target that uses AT&T or Verizon network and use the Straight Talk plan from Walmart?

    Can you get an iphone 5 at target that uses AT&T or Verizon network and use the Straight Talk plan from Walmart? I don't have AT&T or Verizon network and I don't want to get them but I was just wondering if you can get the iphone 5 that is at target and use it for the straight talk plan. I will be getting the straight talk plan but I would like to do some research on the iphone 5 first for straight talk. At walmart the phone is $544.99 and I think it will be a lot cheaper to buy it at target.
    Thank You!

    When I use find file http://www.macupdate.com/app/mac/30073/find-file (which does tend to find files that "Finder" can't), it's not coming up with any other itunes library files that have been modified in the past week, which I know it would have been - unfortunately, I don't have a very recent backup of the hard drive.  It would be a few months old so it wouldn't have the complete library on it....any ideas?  I'm wondering if restarting the computer might help but have been afraid to do so in case it would make it harder to recover anything...I was looking at this thread https://discussions.apple.com/thread/4211589?start=0&tstart=0 in the hopes that it might have a helpful suggestion but it's definitely a different scenario.

  • Can anyone suggest an international GPS nav app that offers map and POI downloads for offline access and route search?

    I'm going to be in the UK with an American phone, don't expect mobile data, and I'd like to use this app instead of the £30 up charge for a rental GPS... I've seen the free Navfree and the cheap as free MotionX Drive, but have read Navfree has some spotty routing and MotionX won't allow regional (or even whole city, ftm) map downloads.

    At $90 for the UK maps this is a too pricey for the use case. In case it wasn't clear, I'm visiting the UK short term so I shouldn't spend more than the £30 to hire a GPS nav system.
    Thanks for the suggestion! Any other ideas?

  • How can you build time series measures in OBIEE without using TODATE AGO fu

    How can you build time series measures in OBIEE without using TODATE and AGO function?
    Please provide steps to build time series
    measures in OBIEE without using TODATE and
    AGO function. Dashboard results not storing
    in cache when using TODATE and AGO functions.
    eventhough its cached users queries not
    hitting cache because queries doesn't match
    exact date time when using TODATE and AGO
    functions. so I want to build queries using
    sysdate and some simple calculations. Please
    send your inputs/ideas for my questions..
    Thanks in Advance

    This can be using Msum function in answers. Use the following formula, here dollars is my metric. Change the formula based on your metric.
    Msum("Sales Measures".Dollars ,2) - "Sales Measures".Dollars
    the report will be cached and better performed compared with time series. check ti
    - Madan Thota

  • Adobe Elements redemption code? hat do you suggest? I need the serial number to activate and can't find a phone number to call anyone to help!

    I bought Adobe Elements in a box. I have looked for the redemption code and taken what appears to be a code from the back of the box, and another from the envelope. They don't work. What do you suggest? I need the serial number to activate and can't find a phone number to call anyone to help! Please contact me at [removed]
    [personal information removed... Mod - https://forums.adobe.com/docs/DOC-3731]
    [This is an open forum, not Adobe support, please do not post personal information]

    Photoshop Elements is not part of the Cloud, I will move this to that forum
    Photoshop Elements Forum http://forums.adobe.com/community/photoshop_elements
    Select a topic, then click I STILL NEED HELP to activate Photoshop Elements Online chat
    -http://helpx.adobe.com/contact.html?product=photoshop-elements or
    http://helpx.adobe.com/photoshop-elements/kb/troubleshoot-installation-photoshop-elements- premiere.html

  • I am unable to activate the sim in my ipad air 5th generation can you suggest how i can activate

    i brought ipad air cellular model and inserted nano sim card but i am unable to dial number because there is no display of numarical pad to dial. But on left side i am getting the netwaork name DU with 5round ponits. Can you suggest it is required any software to activate.

    The ipad is not a cellular phone and does not make phone calls without third party apps that convert data to cellular.
    The intent of the cellular sim in the ipad is for data usage, such as browsing or app connections, not cellular phone calls.

  • HT1222 My mouse pointer in finder is not working by double clicking on the application.I have to double click and select open for opening the application.Can you suggest me some settings to fix this problem?

    My mouse pointer in finder is not working by double clicking on the application.I have to double click and select open for opening the application.Can you suggest me some settings to fix this problem?

    Hi,
    Try this ... reboot your Mac and see if double clicking works again.
    Also, you can just select the Application you like to open and hold down the Command+O to open.
    Also, did you check your setting for the mouse in system preferences.
    Dimaxum

  • Can you suggest a product to protect my screen?

    The screen gets always dusty and i dont want to be cleaning it everyday.Can you suggest a product that covers my screen while using it to avoid contact with dust?

    What model MacBook Pro, by year, processor speed, MacPro 3,1 designation or other ?
    glossy or matte display ?

  • Can you suggest a best way to store and read arabic from oracle database?

    Hi ,
    can you suggest a best way to store and read arabic from oracle database?
    My oracle database is Oracle Database 10g Release 10.1.0.5.0 - 64bit Production on unix HP-UX ia64.
    NLS_NCHAR_CHARACTERSET AL16UTF16
    NLS_LANGUAGE AMERICAN
    NLS_TERRITORY AMERICA
    NLS_CHARACTERSET WE8ISO8859P1
    I have presently stored the data in nvarchar2 field. But i am not able to display it correctly.

    Using the national characterset should work but there are other factors that you have to consider when working with NCHAR/NVARCHAR2/NCLOB.
    If possible, changing the characterset is usually the best solution if it's a possiblity for you.
    For more info:
    Dear Gurus: Can u pls explain the difference between VARCHAR2 & NVARCHAR2??

  • Can you suggest a good compatible modem for Airport?

    Can you suggest a good modem that is compatible with airport express?

    Just to add to turbo..
    Your modem is maybe cable.. which is not adsl..
    Or adsl which is not fibre..
    Or perhaps wireless and not adsl
    Or satellite and not wireless.
    Or vdsl and not satellite
    Or is it direct copper and not vdsl
    Or it could be cable.. and we start around again.
    A good modem is more than likely supplied by your ISP.. although that is not universal.. some hint of ISP and broadband type is a big step forward.

  • Can you edit Muse website without Muse?

    I'm creating a website for a community group.  I'd like them to be able to update their annoucements and events without my help if they need to.  For events, we can use a Google calendar but if they want to update the front page with an announcement or something, I'd like them to able to do so.  Some of the people are ok with code but do not have access to Muse software.
    Can you edit Muse website without have Muse?
    Should I create the website in a different way like Weebly, etc?
    Thanks

    Yes, I've got the Creative Cloud thing so I was going to host it there.  It's a community garden that's just getting started and I'll be traveling for a few weeks this summer and I'm afraid that they may need to update things while I'm gone.  Plus I don't want to be the sole person who can keep it going.

  • Update to Muse CC 2014.3 still have problem upload to FTP: Server not responding in time, FTP may not be supported on this server [Connection timed out after 15001 millseconds.] I have no problem with CC 2014. Can you suggest what do I have to do?

    Update to Muse CC 2014.3 still have problem upload to FTP: Server not responding in time, FTP may not be supported on this server [Connection timed out after 15001 millseconds.] I have no problem with CC 2014. Can you suggest what do I have to do?

    Hello.
    Today I got the opportunity to work with a Muse user with the same issue after performing the troubleshooting steps in the post above we decided to contact the host.
    Later i came to know that host took Muse user's IP and they were able to unblock it and muse started connecting to FTP host.
    I another scenario Host suggested Muse user to add :21 to the FTP address and then Muse was able to connect.
    Eg    ftp.domain.com:21
    Please try the 2 suggestion above and let me know if it works.
    Regards
    Vivek

  • HT1296 My Outlook 2003 calendar is not syncing. Can you suggest some solutions?

    My iPhone 4s is not syncing my Outlook 2003 calendar when connect via USB cable. Can you suggest solutions?

    Hi Jon,
    You may have to Reset the Sync history, as shown here: http://support.apple.com/kb/HT1692. This would force the Merge or Replace syncing options to be shown the next time you sync calendar events.
    If the issue persists, try the advanced troubleshooting tips in this article: http://support.apple.com/kb/TS2776
    -Jason

  • I am using iPhoto 11 and my library has 736.5mb on disk. I have problems with iPhoto stalling and needing to force quit. I have rebuilt my library. Can you suggest anything else?

    I am using iPhoto 11 and my library has 736.5mb on disk. I have problems with iPhoto stalling and needing to force quit. I have rebuilt my library. Can you suggest anything else? Thanks, Rose

    Make a temporary, backup copy (if you don't already have a backup copy) of the library and try the following:
    1 - delete the iPhoto preference file, com.apple.iPhoto.plist, that resides in your
         User/Home()/Library/ Preferences folder.
    2 - delete iPhoto's cache file, Cache.db, that is located in your
         User/Home()/Library/Caches/com.apple.iPhoto folder. 
    Click to view full size
    3 - launch iPhoto and try again.
    NOTE: If you're moved your library from its default location in your Home/Pictures folder you will have to point iPhoto to its new location when you next open iPhoto by holding down the Option key when launching iPhoto.  You'll also have to reset the iPhoto's various preferences.
    NOTE 2:  In Lion and Mountain Lion the Library folder is now invisible. To make it permanently visible enter the following in the Terminal application window: chflags nohidden ~/Library and hit the Enter button - 10.7: Un-hide the User Library folder.
    If that does'nt help log into another user account on your Mac and try iPhoto from there. 

  • Can you suggest how I can make only "salesperson" field mandatory?????

    Hi gurus,
    I want to make the field "Salesperson" in the Communication tab in the PO header mandatory.
    When I set the field selection accordingly(field "salesperson" as required entry), other fields such as your reference, our reference, telephone number becomes mandatory.
    can you suggest how I can make only "salesperson" field mandatory without making related fields mandatory?????
    Regards
    Sara

    Hi,
    Go to spro->MM->purchasing->PO->Define screen out at document -> select NBF ->Reference data, header->set field Reference, salesperson etc. as mandatory.
    reward full point if resolve,
    Regards,
    Chetan.

Maybe you are looking for