Skip to content

Commit

Permalink
URL modifications
Browse files Browse the repository at this point in the history
  • Loading branch information
aabeatty committed Aug 1, 2024
1 parent 0b4b7f4 commit fcd1f5f
Show file tree
Hide file tree
Showing 81 changed files with 143 additions and 134 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,7 @@
<cmd>Now try an exercise on your own. Open the file
lesson3/lc_task_exercise_start.dita and use it to convert the following
assessment question from <xref source="external"
href="httpss://learningdita.com/courses/the-dita-task-topic-type/">The
href="https://learningdita.com/courses/the-dita-task-topic-type/">The
DITA task topic type</xref> LearningDITA course into a DITA
&lt;learningAssessment> topic.</cmd>
<info>The answer choices are matched correctly in this preview.</info>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,13 @@
DITA, including how to create courses and assessments.</p>
<p>This course builds on previous courses. Before starting this course we recommend that
you at least take these courses: <xref
href="httpss://learningdita.com/courses/introduction-to-dita/">Introduction to
href="https://learningdita.com/courses/introduction-to-dita/">Introduction to
DITA</xref>, <xref
href="httpss://learningdita.com/courses/the-dita-task-topic-type/">The DITA task
href="https://learningdita.com/courses/the-dita-task-topic-type/">The DITA task
topic type</xref>, <xref
href="httpss://learningdita.com/courses/using-dita-maps-and-bookmaps/">Using DITA
href="https://learningdita.com/courses/using-dita-maps-and-bookmaps/">Using DITA
maps and bookmaps</xref>, and <xref
href="httpss://learningdita.com/courses/intro-to-reuse-in-dita/">Introduction to
href="https://learningdita.com/courses/intro-to-reuse-in-dita/">Introduction to
reuse in DITA</xref>.</p>
</lcIntro>
</learningContentbody>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@
</learningContentbody>
<related-links>
<link format="html" scope="external"
href="httpss://www.oxygenxml.com/dita/1.3/specs/archSpec/learningTraining/lc-spec-Overview-domains.html#concept_cvq_vzc_ll__section_95070B5E06F6489A94C301B0D77DF71E">
href="https://www.oxygenxml.com/dita/1.3/specs/archSpec/learningTraining/lc-spec-Overview-domains.html#concept_cvq_vzc_ll__section_95070B5E06F6489A94C301B0D77DF71E">
<linktext>Support for learningDomain1 and learningDomain2</linktext>
</link>
</related-links>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@
<step>
<cmd>Open the file lesson3/lc_task_exercise_start.dita and use it to convert the
following content from a LearningDITA course, <xref
href="httpss://learningdita.com/courses/the-dita-task-topic-type/">The
href="https://learningdita.com/courses/the-dita-task-topic-type/">The
DITA task topic type</xref>, into a DITA &lt;learningConcept> topic with
an embedded task.</cmd>
<info>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
you need to deliver your learning content.</p>
<p>A learning object is a “discrete reusable collection of content used to present and
support a single learning objective” (<xref
href="httpss://www.oasis-open.org/committees/download.php/35764/lc_spec_assumptions.html"
href="https://www.oasis-open.org/committees/download.php/35764/lc_spec_assumptions.html"
>OASIS, A learning objects approach to learning and training
content</xref>).</p>
<p>The L&amp;T specialization implements learningObjects with the &lt;learningObject>
Expand Down
2 changes: 1 addition & 1 deletion en-us/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ To get started, read the project documentation, found in the docs folder.

The project roadmap is part of the GitHub wiki. It lists the course sequencing and shows which courses are currently under development and by whom.

httpss://github.com/okeefescriptorium/ditatraining/wiki/Project-roadmap
https://github.com/okeefescriptorium/ditatraining/wiki/Project-roadmap

Course content is published by Scriptorium at https://www.learningDITA.com
Original file line number Diff line number Diff line change
Expand Up @@ -35,12 +35,13 @@
</learningContentbody>
<related-links>
<!-- [SP] AAB 2024-07-29 Updated dead link to current resource on block vs inline elements. -->
<link href="httpss://www.w3schools.com/html/html_blocks.asp" scope="external" format="html"><linktext>HTML Block and Inline Elements, w3schools.com</linktext></link>
<link href="https://www.w3schools.com/html/html_blocks.asp" scope="external" format="html"><linktext>HTML Block and Inline Elements, w3schools.com</linktext></link>
<link
href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/c_Syntax_and_Markup.html"
href="https://www.oxygenxml.com/dita/styleguide/c_Syntax_and_Markup.html"
format="html" scope="external">
<linktext>DITA Style Guide, Chapter 3, Syntax and mark-up</linktext>
</link>
<!-- [SP] AAB 2024-07-29 TO DO: Update link to DITA spec -->
<link href="https://docs.oasis-open.org/dita/v1.2/os/spec/DITA1.2-spec.html" format="html"
scope="external">
<linktext>Darwin Information Typing Architecture (DITA) Version 1.2, OASIS
Expand Down
11 changes: 6 additions & 5 deletions en-us/course01-intro/topics/lc_dita_intro.dita
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
<lcIntro>
<p>DITA stands for Darwin Information Typing Architecture. It is an open standard,
originally created by IBM. IBM donated DITA to <xref
href="httpss://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita"
href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita"
format="html" scope="external">OASIS</xref> (the Organization for the
Advancement of Structured Information Standards) in 2005.</p>
<p>DITA is an XML-based, tool-independent way to create, organize, and manage content.
Expand All @@ -45,9 +45,10 @@
</lcIntro>
</learningContentbody>
<related-links>
<link href="https://dita.xml.org/book/export/html/1047" scope="external" format="html">
<!--[AAB 2024-07-31] dead link
<link href="https://dita.xml.org/book/export/html/1047" scope="external" format="html">
<linktext>History of DITA</linktext>
</link>
</link>-->
<link href="https://www.w3.org/html/wg/wiki/DraconianErrorHandling" format="html"
scope="external">
<linktext>Draconian error handling</linktext>
Expand All @@ -57,11 +58,11 @@
<linktext>The ten commandments of DITA, Scriptorium blog</linktext>
</link>
<link
href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/c_Syntax_and_Markup.html"
href="https://www.oxygenxml.com/dita/styleguide/c_Syntax_and_Markup.html"
format="html" scope="external">
<linktext>DITA Style Guide, Chapter 3, Syntax and Markup</linktext>
</link>
<link href="httpss://github.com/flicstar/DITA-Mini-Manual" format="html" scope="external">
<link href="https://github.com/flicstar/DITA-Mini-Manual" format="html" scope="external">
<linktext>Sample DITA content: a documentation project based on a 1960s Mini Owner’s
Manual, contributed by Felicity Brand</linktext>
</link>
Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/lc_gloss.dita
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
</ul>
</p>
<p> Video: <xref
href="httpss://www.youtube.com/watch?v=a_Cr1lX3WAM" format="html"
href="https://www.youtube.com/watch?v=a_Cr1lX3WAM" format="html"
scope="external">Code overview of the DITA glossary topic</xref></p>
</lcInstruction>
</learningContentbody>
Expand Down
12 changes: 9 additions & 3 deletions en-us/course01-intro/topics/lc_infotypes.dita
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,16 @@

</learningContentbody>
<related-links>
<link href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/c_Topics_and_Information_Types.html" format="html" scope="external"><linktext>DITA Style Guide, Chapter 1</linktext></link>
<link href="https://www.oxygenxml.com/dita/styleguide/c_Topics_and_Information_Types.html" format="html" scope="external">
<linktext>DITA Style Guide, Chapter 1</linktext>
</link>
<!-- [AAB 2024-07-29] Updated scriptorium.com/books to current resources page and added link to content transformation book. -->
<link href="https://www.scriptorium.com/resources/" scope="external" format="html"><linktext>Scriptorium Resources</linktext></link>
<link href="https://www.scriptorium.com/content-transformation/" scope="external" format="html"><linktext>Content Transformation book</linktext></link>
<link href="https://www.scriptorium.com/resources/" scope="external" format="html">
<linktext>Scriptorium Resources</linktext>
</link>
<link href="https://www.scriptorium.com/content-transformation/" scope="external" format="html">
<linktext>Content Transformation book</linktext>
</link>
</related-links>

</learningContent>
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/lc_markup.dita
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@
you'll be creating DITA content using smart authoring tools that handle the
individual tags and attributes for you. </note>
<!--<p>The most commonly used markup language is HTML. XML is similar to HTML. It also uses angle brackets to indicate elements (like &lt;p>). Many of the tags in DITA XML are also found in HTML.</p><p>In XML, you must be careful to open and close all tags properly. HTML is forgiving when you make mistakes. XML requires you to provide a file that is tagged correctly. If you make any error in the encoding, parsing stops. This is known as draconian error handling, and it is a controversial part of the XML specification.</p><p>DITA is a markup language and is a flavor of XML. DITA allows you to mark up content semantically. The tag markup tells the author about the meaning of the markup.</p>-->
<p>Video: <xref href="httpss://youtu.be/1cYP5six9ww" format="html" scope="external">Overview
<p>Video: <xref href="https://youtu.be/1cYP5six9ww" format="html" scope="external">Overview
of HTML markup versus DITA markup</xref></p>

</lcInstruction>
Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/lc_reference.dita
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
<li>&lt;properties> (a list of properties)</li>
<li>&lt;refsyn> (a syntax diagram)</li>
</ul></p>
<p>Video: <xref href="httpss://www.youtube.com/watch?v=l2y-MbYf2a4" format="html"
<p>Video: <xref href="https://www.youtube.com/watch?v=l2y-MbYf2a4" format="html"
scope="external">Code overview of the DITA reference topic</xref></p>
</lcInstruction> </learningContentbody>
</learningContent>
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/lc_task.dita
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
</ul></li>
<li>&lt;example> (an example of how to do the entire task)</li>
</ul></p>
<p>Video: <xref href="httpss://youtu.be/PWSRhPnMDNs" format="html" scope="external">Code
<p>Video: <xref href="https://youtu.be/PWSRhPnMDNs" format="html" scope="external">Code
overview of DITA task topic</xref></p>
</lcInstruction>

Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/links/lc_conrefs.dita
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@
conref attribute. Thus you can only conref a &lt;note> element from another
&lt;note> element; you can only conref an &lt;li> element from another &lt;li>
element, and so on.</note>
<p>Video: <xref href="httpss://www.youtube.com/watch?v=oHmXBRVk3yo" format="html"
<p>Video: <xref href="https://www.youtube.com/watch?v=oHmXBRVk3yo" format="html"
scope="external">DITA conref code example</xref></p>
<note type="tip">It's a good practice to create separate topics that contain reusable
elements, rather than just picking a random topic and pointing a conref to that
Expand Down
4 changes: 2 additions & 2 deletions en-us/course01-intro/topics/links/lc_maps.dita
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
<p>You generally do not add all available topics to a map file—just the ones you want
included in a deliverable. Also, you can include the same topic in multiple map
files, which is another example of reuse in DITA.</p>
<p>Video: <xref href="httpss://www.youtube.com/watch?v=I_yvE9_ECRw" format="html"
<p>Video: <xref href="https://www.youtube.com/watch?v=I_yvE9_ECRw" format="html"
scope="external">Example of a DITA map file</xref></p>

<p>Map files are made up mainly of the following components:<ul id="ul_dy2_k3q_wr">
Expand Down Expand Up @@ -67,7 +67,7 @@
<pre>&lt;topicref href="fish.dita">
&lt;topicref href="shorebirds.dita">
<b>&lt;mapref href="ducks.ditamap" format="ditamap"/></b></pre>
<p>Video: <xref href="httpss://www.youtube.com/watch?v=5gXZN505XFQ" format="html"
<p>Video: <xref href="https://www.youtube.com/watch?v=5gXZN505XFQ" format="html"
scope="external">Reusing a map file in a map file</xref></p>

</lcInstruction>
Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/links/lc_relationships.dita
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@
table cell attributes will be described in a future course. </note><p>The
relationships you capture in the reltable are <i>not</i> typically shown when you
are authoring topics.</p><p>Video: <xref
href="httpss://www.youtube.com/watch?v=vMUxQpQvTZg" format="html"
href="https://www.youtube.com/watch?v=vMUxQpQvTZg" format="html"
scope="external">Overview of DITA relationship table (reltable)</xref>
</p><p>Start simple with reltables. They can get very complex.</p><p>Reltables are
preferred over related links or xrefs for links within a map file because of the
Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/links/lc_transforming.dita
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@
<link href="https://www.dita-ot.org" scope="external" format="html">
<linktext>DITA Open Toolkit</linktext>
</link>
<link href="httpss://www.youtube.com/watch?v=xFPRnJrRo8o" scope="external" format="html">
<link href="https://www.youtube.com/watch?v=xFPRnJrRo8o" scope="external" format="html">
<linktext>Getting started with the DITA Open Toolkit, Suite Solutions webinar (video, 53 minutes)</linktext>
</link>

Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/links/lc_xrefs.dita
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
<note>Although it might seem like the right thing to do, when creating a cross-reference
to a section, figure, or table, the href attribute should specify the section,
figure, or table, not the &lt;title> element within the section, figure, or table. </note>
<p>Video: <xref href="httpss://www.youtube.com/watch?v=Go2FyJl7uQY" format="html"
<p>Video: <xref href="https://www.youtube.com/watch?v=Go2FyJl7uQY" format="html"
scope="external">Code examples of DITA cross-references</xref>
</p>
<p>You can also use the &lt;xref> element to link to resources outside your DITA topics.
Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/metadata/lc_metadata.dita
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
</learningContentbody>
<related-links>
<link
href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/c_Types_of_Metadata.html"
href="https://www.oxygenxml.com/dita/styleguide/c_Types_of_Metadata.html"
format="html" scope="external">
<linktext>DITA Style Guide, Chapter 8, Metadata, conditional processing, and
indexing</linktext>
Expand Down
2 changes: 1 addition & 1 deletion en-us/course01-intro/topics/tables/lc_tables.dita
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@
</learningContentbody>
<related-links>
<link
href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Syntax_and_Markup/c_Tables.html"
href="https://www.oxygenxml.com/dita/styleguide/Syntax_and_Markup/c_Tables.html"
scope="external" format="html">
<linktext>DITA Style Guide, Chapter 3, Table section</linktext>
</link>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
</section>
<section>
<title>Content is not appropriate for the target audience</title>
<lq href="httpss://www.scriptorium.com/content-transformation/" format="html" scope="external">The information is targeted at the
<lq href="https://www.scriptorium.com/content-transformation/" format="html" scope="external">The information is targeted at the
wrong audience. For example, a document intended for patients in a hospital uses complex medical terminology that only medical professionals would understand.</lq>
</section>
</conbody>
Expand Down
4 changes: 2 additions & 2 deletions en-us/course02-authoring_concepts/topics/lc_advanced.dita
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@
&lt;/conbody>
&lt;/concept></pre>
</stepxmp>
<info>Video: <xref href="httpss://www.youtube.com/watch?v=Ryzutuy-n_A"
<info>Video: <xref href="https://www.youtube.com/watch?v=Ryzutuy-n_A"
format="html" scope="external">Creating a codeblock in
DITA</xref></info>
</step>
Expand Down Expand Up @@ -142,7 +142,7 @@ the name of the duck in parentheses on the command line and press Enter.&lt;/p><
&lt;conbody>
...
&lt;/p>
<ph outputclass="newchanged">&lt;lq href="httpss://commons.digitalthoreau.org/walden/the-ponds/the-ponds-18-34/" format="html" scope="external">How much fairer than the pool before the farmers door,
<ph outputclass="newchanged">&lt;lq href="https://commons.digitalthoreau.org/walden/the-ponds/the-ponds-18-34/" format="html" scope="external">How much fairer than the pool before the farmers door,
in which his ducks swim! Hither the clean wild ducks come. Nature has no human
inhabitant who appreciates her. The birds with their plumage and their notes are in
harmony with the flowers, but what youth or maiden conspires with the wild luxuriant
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,11 +54,12 @@
</learningContentbody>
<related-links>
<link
href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Syntax_and_Markup/c_List_of_Domains.html"
href="https://www.oxygenxml.com/dita/styleguide/Syntax_and_Markup/c_List_of_Domains.html"
format="html" scope="external">
<linktext>DITA Style Guide, Element domains</linktext>
</link>
<!--<link href="https://docs.oasis-open.org/dita/v1.2/os/spec/langref/codeblock.html"
<!-- [AAB 2024-07-31] TO DO: Update links to DITA spec. -->
<link href="https://docs.oasis-open.org/dita/v1.2/os/spec/langref/codeblock.html"
format="html" scope="external">
<linktext>OASIS DITA Version 1.2 Standard, &lt;codeblock></linktext>
</link>
Expand All @@ -81,6 +82,6 @@
<link href="https://docs.oasis-open.org/dita/v1.2/os/spec/langref/required-cleanup.html"
format="html" scope="external">
<linktext>OASIS DITA Version 1.2 Standard, &lt;required-cleanup></linktext>
</link>-->
</link>
</related-links>
</learningContent>
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@
<step>
<cmd>After the &lt;ol> element, add a &lt;note> element and add content to it as shown
in the following example:</cmd>
<info>Video: <xref href="httpss://www.youtube.com/watch?v=ByrO1K1OTIA"
<info>Video: <xref href="https://www.youtube.com/watch?v=ByrO1K1OTIA"
format="html" scope="external">Creating a note in DITA</xref></info>
<stepxmp>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?>
Expand Down
Loading

0 comments on commit fcd1f5f

Please sign in to comment.