More details on building articles for publication

Author: robjhyndman

vignettes/issue_build_guide.Rmd

@@ -66,7 +66,7 @@ For each article in the issue:
     ```
 
     This needs an OpenAI API key stored in `.Renviron` as `OPENAI_API_KEY`. Check the copyediting carefully, as the AI can make mistakes. It is usually pretty good on the main article, but often messes up the bib file.
-  * For articles with an Rmd file, make sure it renders to both pdf and html. output should be set to 
+  * For articles with an Rmd file, make sure it renders to both pdf and html. output should be set to:
 
     ```yaml
     output:
@@ -75,14 +75,16 @@ For each article in the issue:
         self_contained: yes
     ```
 
-  * For articles containing a tex file, but no Rmd file, use texor to create the Rmd
+    Many authors include LaTeX-specific or html-specific elements that cause problems. These need to be converted to work in both outputs.
+
+  * For articles containing a tex file, but no Rmd file, use texor to create the Rmd file:
 
     ```r
     texor::latex_to_web("<path to article folder>")
     ```
 
     - The conversion to Rmd can be fragile, especially if authors have defined their own LaTeX macros, or use additional packages. Also tables, equations and equation cross-referencing can need fixing.
-    - This should only produce an html output. The original tex file is used to produce the pdf output. 
+    - The Rmd file created only generates an html output. The original tex file is used to produce the pdf output. 
 
   * If you encounter problems that you can't solve yourself, ask the Technical Editor for assistance.