How to link to a section in MDITA?

From
Scott Hudson <>
Date
2018-05-03T14:20:00+00:00
ID
Thread
How to link to a section in MDITA?
Linking within a topic is a pretty important feature, so I think we should consider this for the future spec.



We will try embedding the HDITA for now.



Thanks,



--Scott
From:

Carlos Evia <>
Date:  Thursday, May 3, 2018 at 8:17 AM
To:  Scott Hudson <>
Cc:  "" <>
Subject:  Re: [dita-lightweight-dita] How to link to a section in MDITA?



  Hi Scott,



  You cannot assign specific @id values to sections in MDITA core. We flirted with the idea of using Pandoc-like identifiers. Example: ## My section {#nice-section} but that was complicated for processors based on
  GitHub-Flavored Markdown.

  You could impose a section id with an HDITA snippet <section id="blah">, but the solution (briefly mentioned in the committee note; page 19 of the PDF version) is that in MDITA titles will be "slugified" (a header
  without an explicitly specified identifier will be automatically assigned a unique identifier based on the header text). We will expand that in the spec... but that's the answer for now.



  I hope it helps!



  Carlos

--
Carlos Evia, Ph.D.

  Associate Professor of Technical Communication

  Virginia Tech
Blacksburg, VA 24061-0112

  (540)200-8201





  On Thu, May 3, 2018 at 9:46 AM, Scott Hudson < 
> wrote:

  Folks,



  As we are testing our implementation, it is not clear in the committee note or in samples how we are supposed to create an @id on sections within a topic (especially in mdita).



  Am I missing something, or do we need to explain this further in the next version of the committee note or spec?



  Thanks and best regards,



  --Scott



  Voting member:

  Boeing Data Standards Technical Advisory Board

  OASIS DocBook TC (Secretary), Publishers SC (Chair)

OASIS DITA TC, Tech Comm SC, LwDITA SC, Learning Content SC (Secretary)

OASIS DITA Adoption TC

  OASIS Augmented Reality in Information Products (ARIP)

TC



Scott Hudson
 Content Strategist, Digital Aviation Learning and Development

  Jeppesen, A Boeing Company

55
  Inverness Drive East
Englewood,
  CO
 80112

  303-328-6228
Cell: 303-350-7934

This document contains only administrative, uncontrolled data under U.S. International Traffic in Arms Regulations.