Editing Single-source workflow (section)

=how:Pandoc / Hybrid Publishing Editor=


==Markups languages==
Markups languages are ways of marking text, giving with words specific hierarchical and visual rendering. 

By marking the text according to markup languages it is possible to:
* add  '''reading aids''', such bold, italic, blockquotes 
* add a clear '''text hierarchy''': section titles, sub-section titles, sub-sub-sub section titles
* '''convert between different markup languages''' - as they are mostly compatible  



==Markup languages examples ==
Each markup uses a different markings

[http://en.wikipedia.org/wiki/HTML HTML]:
<source lang="html4strict">
<h1>Revenge of the Text</h1>
 <p>There is a room in the <strong>Musée d’Orsay</strong> that I call the <em>room of possibilities</em>.</p>
 <p>That room contains:</p>
 <ul>
  <li>a snow flake</li>
  <li>the end of a cloud</li>
  <li>a bit of nothing</li>
 </ul>
</source>

[http://en.wikipedia.org/wiki/Markdown Markdown]: <ref>Markdown Syntax in http://daringfireball.net/projects/markdown/syntax</ref> 
<pre>
# Revenge of the Text
There is a room in the **Musée d’Orsay** that I call the *room of possibilities*.

That room contains:
* a snow flake
* the end of a cloud
* a bit of nothing
</pre>


ICML (xml):
<source lang="xml">
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/Header1">
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>Revenge of the Text</Content>
  </CharacterStyleRange>
</ParagraphStyleRange>
<Br />
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/Paragraph">
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>There is a room in the </Content>
  </CharacterStyleRange>
  <CharacterStyleRange AppliedCharacterStyle="CharacterStyle/Bold">
    <Content>Musée d’Orsay</Content>
  </CharacterStyleRange>
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content> that I call the </Content>
  </CharacterStyleRange>
  <CharacterStyleRange AppliedCharacterStyle="CharacterStyle/Italic">
    <Content>room of possibilities</Content>
  </CharacterStyleRange>
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>.</Content>
  </CharacterStyleRange>
</ParagraphStyleRange>
<Br />
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/Paragraph">
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>That room contains:</Content>
  </CharacterStyleRange>
</ParagraphStyleRange>
<Br />
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/BulList &gt; first" NumberingContinue="false">
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>a snow flake</Content>
  </CharacterStyleRange>
</ParagraphStyleRange>
<Br />
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/BulList">
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>the end of a cloud</Content>
  </CharacterStyleRange>
</ParagraphStyleRange>
<Br />
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/BulList">
  <CharacterStyleRange AppliedCharacterStyle="$ID/NormalCharacterStyle">
    <Content>a bit of nothing</Content>
  </CharacterStyleRange>
</ParagraphStyleRange>

</source>




==Word styles in manuscript (.docx)==


If changes to the manuscript are needed, use '''paragraph styles''' in MS Word/Libre Office/Open Office to '''"mark" the text, so as to allow those structural markings to propagate to ICML(inDesign) and HTML(website)'''. 

Some existing paragraph and characters styles:
* headings: heading1, heading2, etc
* body text: regular text 
* block quotes: indented blocks of text
* footnotes
* hyperlinks 
* Preformatted text as in <pre>Hello world</pre>
* Bold
* Italics 

Save in '''.docx'''. Pandoc cannot read .doc, only .docx

==Pandoc==
{{:Pandoc}}

Pandoc has a text-based interface, which can be challenging to use, to those unused to use the command-line terminal. 

Luckily there are a few Web interfaces to Pandoc, such as '''[http://artserver.org/~andre/hybrideditor/ Hybrid Publishing Editor]''' by [http://automatist.org/ Michael Murtaugh]

[[File:Hype.png|thumbnail|Hybrid Editor]]


-----
==ICML==
{{:ICML}}





----