X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fguides%2Fonap-developer%2Fhow-to-use-docs%2Fconverting-formats.rst;h=835a9c5a219cb17e27a4d0e4bee3191e2b27cf26;hb=2b99cfe91bc6b0fb1d61fe4703ec61741563081d;hp=5321a18dfae381a43c1207a114a39a71883a1ec3;hpb=e4ce69915138d4830bad9fa069ce3013a1a82d29;p=doc.git diff --git a/docs/guides/onap-developer/how-to-use-docs/converting-formats.rst b/docs/guides/onap-developer/how-to-use-docs/converting-formats.rst index 5321a18df..835a9c5a2 100644 --- a/docs/guides/onap-developer/how-to-use-docs/converting-formats.rst +++ b/docs/guides/onap-developer/how-to-use-docs/converting-formats.rst @@ -1,4 +1,6 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. This work is licensed under a Creative Commons Attribution 4.0 +.. International License. http://creativecommons.org/licenses/by/4.0 +.. Copyright 2017 AT&T Intellectual Property. All rights reserved. .. _converting-to-rst: @@ -8,12 +10,17 @@ Converting to RST Installing pandoc ----------------- -Pandoc is a powerful document-transformation utility. We'll use it to do simple conversions, but it is capable of much more. Visit the `pandoc website `_ for installation instructions for your platform. +Pandoc is a powerful document-transformation utility. We'll use it to +do simple conversions, but it is capable of much more. Visit +the `pandoc website `_ for +installation instructions for your platform. Converting ---------- -Using a terminal, navigate to the directory containing the documents you wish to convert. Next, issue the following command for each file you'd like to convert: +Using a terminal, navigate to the directory containing the documents +you wish to convert. Next, issue the following command for each file +you'd like to convert: :code:`pandoc -s --toc -f -t rst myfile.` @@ -76,7 +83,9 @@ Using a terminal, navigate to the directory containing the documents you wish to Fixing the converted document ----------------------------- -How much you'll need to fix the converted document depends on which file format you're converting from. Here are a couple of things to watch out for: +How much you'll need to fix the converted document depends on which file +format you're converting from. Here are a couple of things to watch out +for: 1. Multi-line titles need to be converted to single line 2. Standalone "**" characters @@ -89,7 +98,5 @@ Previewing edits Web-based ~~~~~~~~~ -`rst.ninjs.org `_ has an excellent RST previewing tool that highlights RST errors with line numbers. - - - +`rst.ninjs.org `_ has an excellent RST previewing +tool that highlights RST errors with line numbers.