asciidoctor-latex 1.5.0.11.dev → 1.5.0.12.dev

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 64058070ab85bbf4391b2471331cd7d89d580296
-  data.tar.gz: a590808eecff4ea7c41d6cd851be648ce2b5e955
+  metadata.gz: 8f1d2505677112b0ffd3fbc854273705eb5d5ffe
+  data.tar.gz: 114ad1a02c25e393835d1ef1c38151f606876537
 SHA512:
-  metadata.gz: 1bbffba791addfd5ea5b80d984977cbd73b1c89b56f7b90fcbc2dc6ebd4584cff788e0a701a54b94a8557fcf30a1f4b8315ef7c282129a281298e729f76c7566
-  data.tar.gz: e08cd366b050af28eff4bd37051a46c4e13456d42c04bfd61f4de00159b6d8d3ab0ed3adbbb44c49fd6124d8bdf93b66f01c91af39060311f7896eccdadf02ae
+  metadata.gz: 0f65b4de8dea52bfdee30f8b9f88d75737e58146843992d7b9a49a88e910d10fa9b84f40450e33b0a1bcf4f920aa642cec508f899b1ebe3b64d0d89afd77672e
+  data.tar.gz: def2e887596b4e1f4db3669588a13b6a3277376db339218c8cc64d771c4d12ca4ed20ac6a16e9e61382f7da5cc91cdb4a6915e9b9f14d030393606e78eb78f19

data/CHANGELOG.adoc

@@ -22,6 +22,16 @@ for cross-referencing, e.g.,
 `[env.equation#hohoho]`, then it is numbered.
 ////
 
+
+1.5.0.12.dev:: Fix issue #44 in which the file
+macros.tex is ignored in the latex dialect
+when using the html backend.
+
+
+1.5.0.11.dev:: Enable the syntax
+`Asciidoctor.convert str, { 'dialect' => 'latex' }`
+for specifying the dialect in the Ruby API.
+
 1.5.0.10.dev:: NOTE: Version 1.5.0.10 introduces
 a new syntax with switches for three 'dialects'
 of asciidoc: asciidoc itself, 'manuscript',

data/README.adoc

@@ -57,28 +57,26 @@ https://rubygems.org/gems/asciidoctor-latex[RubyGems.org]
 Beta alert!
 
 NOTE: Version 1.5.0.7 is "stable".  Version 1.5.0.9 introduces
-new syntax with switches for three 'dialects' See below.
-
-# Invoke asciidoctor-latex for LaTeX output by
-#
-#   asciidoctor-latex -a dialect=asciidoc foo.adoc
-#   asciidoctor-latex -a dialect=manuscript foo.adoc
-#   asciidoctor-latex -a dialect=latex foo.adoc
-#
-# Be sure to use XeLaTex for tex'ing
-# For html output, use
-#
-#   asciidoctor-latex -a dialect=asciidoc foo.adoc -b html
-#   asciidoctor-latex -a dialect=manuscript foo.adoc -b html
-#   asciidoctor-latex -a dialect=latex foo.adoc -b html
-#
-# The above are *source file* options for dialects of asciidoc:
-#
-#   asciidoc
-#   asciidoc-manuscript
-#   asciidoc-latex
-#
-#
+
+new syntax with switches for three 'dialects'. See below.
+
+There are three dialects that you can set with the `:dialect` attribute:
+
+- `asciidoc`
+- `asciidoc-manuscript`
+- `asciidoc-latex`
+
+See the option flag `-a` to set the dialect from the command line. For example:
+
+ $ asciidoctor-latex -a dialect=manuscript foo.adoc
+
+Be sure to use XeLaTex for tex'ing.
+
+To set the dialect with the Ruby API, use for example :
+
+----
+      Asciidoctor.convert str, { 'dialect' => 'latex' }
+----
 
 === From GitHub
 
@@ -92,7 +90,7 @@ If you would like to install a development version from the repository, use:
 
 == Commands
 
-Asciidoc math files can be rendered
+Asciidoc math files can be rendered as follows
 
 Render as HTML::
 Use `$ asciidoctor-latex -b html foo.adoc` to produce `foo.html`.
@@ -105,7 +103,7 @@ to produce `foo.tex`.
 
 === Macro files
 
-The contents of a file named `macros.tex` will
+The contents of a file named `macros.tex` will be
 read and used by `asciidoctor-latex`
 if it is in the same directory as the file
 being rendered.  This is the case regardless
@@ -114,9 +112,9 @@ of the output format -- HTML or tex.
 
 === Switches
 
-asciidoctor-latex -a header=no foo.adoc::
-Use a minimal header for the generated tex file.
+To generate a tex file with a minial header, do:
 
+ $ asciidoctor-latex -a header=no foo.adoc
 
 {adlp}'s default form at is `:latexmath`.
 To use `:stem`, put the text `:stem:`

data/Rakefile

@@ -41,12 +41,14 @@ begin
 
     DocTest::GeneratorTask.new(:latex) do |t|
       t.converter_opts[:backend_name] = :latex
+      t.converter_opts[:dialect] = :latex
       t.output_suite = DocTest::Latex::ExamplesSuite.new(examples_path: 'test/examples/tex')
       t.examples_path.unshift 'test/examples/adoc'  # extra input examples
     end
 
     DocTest::GeneratorTask.new(:html) do |t|
       t.converter_opts[:backend_name] = :html
+      t.converter_opts[:dialect] = :latex
       t.output_suite = DocTest::HTML::ExamplesSuite.new(examples_path: 'test/examples/html')
       t.examples_path = ['test/examples/asciidoc-html']  # input examples
     end

data/doc/Asciidoctor/Block.html

@@ -366,6 +366,32 @@ example problem equation)</p>
   
     <span class="summary_desc"><div class='inline'></div></span>
   
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#handle_include_latex-instance_method" title="#handle_include_latex (instance method)">- (Object) <strong>handle_include_latex</strong> </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Example: [env.include_latex] – nput abc.text usepackagedef – Nothing
+appears in the HTML, bu lines nput abc.text usepackagedef appear in the
+generated tex file.</p>
+</div></span>
+  
 </li>
 
       
@@ -865,26 +891,6 @@ example problem equation)</p>
       <pre class="lines">
 
 
-496
-497
-498
-499
-500
-501
-502
-503
-504
-505
-506
-507
-508
-509
-510
-511
-512
-513
-514
-515
 516
 517
 518
@@ -908,10 +914,30 @@ example problem equation)</p>
 536
 537
 538
-539</pre>
+539
+540
+541
+542
+543
+544
+545
+546
+547
+548
+549
+550
+551
+552
+553
+554
+555
+556
+557
+558
+559</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 496</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 516</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_click_process'>click_process</span>
   <span class='id identifier rubyid_attr'>attr</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_attributes'>attributes</span>
@@ -1040,7 +1066,9 @@ example problem equation)</p>
 479
 480
 481
-482</pre>
+482
+483
+484</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 457</span>
@@ -1067,6 +1095,8 @@ example problem equation)</p>
       <span class='id identifier rubyid_handle_box'>handle_box</span>
     <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>texmacro</span><span class='tstring_end'>&#39;</span></span>
       <span class='id identifier rubyid_handle_texmacro'>handle_texmacro</span>
+    <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>include_latex</span><span class='tstring_end'>&#39;</span></span>
+      <span class='id identifier rubyid_handle_include_latex'>handle_include_latex</span>
     <span class='kw'>else</span>
       <span class='id identifier rubyid_handle_plain'>handle_plain</span><span class='lparen'>(</span><span class='id identifier rubyid_env'>env</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
@@ -1091,23 +1121,23 @@ example problem equation)</p>
       <pre class="lines">
 
 
-602
-603
-604
-605
-606
-607
-608
-609
-610
-611
-612
-613
-614
-615</pre>
+622
+623
+624
+625
+626
+627
+628
+629
+630
+631
+632
+633
+634
+635</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 602</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 622</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_example_process'>example_process</span>
   <span class='id identifier rubyid_id'>id</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_attributes'>attributes</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>id</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span>
@@ -1143,19 +1173,19 @@ example problem equation)</p>
       <pre class="lines">
 
 
-618
-619
-620
-621
-622
-623
-624
-625
-626
-627</pre>
+638
+639
+640
+641
+642
+643
+644
+645
+646
+647</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 618</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 638</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_floating_title_process'>floating_title_process</span>
   <span class='id identifier rubyid_doctype'>doctype</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_document'>document</span><span class='period'>.</span><span class='id identifier rubyid_doctype'>doctype</span>
@@ -1187,16 +1217,16 @@ example problem equation)</p>
       <pre class="lines">
 
 
-488
-489
-490
-491
-492
-493
-494</pre>
+508
+509
+510
+511
+512
+513
+514</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 488</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 508</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_handle_box'>handle_box</span>
   <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_title'>title</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='kw'>or</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_title'>title</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span>
@@ -1320,6 +1350,58 @@ example problem equation)</p>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="handle_include_latex-instance_method">
+  
+    - (<tt>Object</tt>) <strong>handle_include_latex</strong> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Example:</p>
+<dl class="rdoc-list label-list"><dt>env.include_latex
+<dd>
+<p>– nput abc.text usepackagedef – Nothing appears in the HTML, bu lines
+nput abc.text usepackagedef appear in the generated tex file.</p>
+</dd></dl>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+501
+502
+503
+504
+505
+506</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 501</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_handle_include_latex'>handle_include_latex</span>
+  <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hi Boss, it&#39;s me again!</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id identifier rubyid_puts'>puts</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_content'>content</span>
+  <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>---------------</span><span class='tstring_end'>&quot;</span></span>
+  <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_content'>content</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1425,12 +1507,12 @@ example problem equation)</p>
       <pre class="lines">
 
 
-484
-485
-486</pre>
+486
+487
+488</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 484</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 486</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_handle_texmacro'>handle_texmacro</span>
   <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>%% User tex macros:\n</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_content'>content</span><span class='embexpr_end'>}</span><span class='tstring_content'>\n%% end of user macros\n</span><span class='tstring_end'>&quot;</span></span>
@@ -1455,26 +1537,6 @@ example problem equation)</p>
       <pre class="lines">
 
 
-629
-630
-631
-632
-633
-634
-635
-636
-637
-638
-639
-640
-641
-642
-643
-644
-645
-646
-647
-648
 649
 650
 651
@@ -1506,10 +1568,30 @@ example problem equation)</p>
 677
 678
 679
-680</pre>
+680
+681
+682
+683
+684
+685
+686
+687
+688
+689
+690
+691
+692
+693
+694
+695
+696
+697
+698
+699
+700</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 629</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 649</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_image_process'>image_process</span>
   <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_attributes'>attributes</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>width</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span>
@@ -1625,12 +1707,12 @@ example problem equation)</p>
       <pre class="lines">
 
 
-598
-599
-600</pre>
+618
+619
+620</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 598</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 618</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_listing_process'>listing_process</span>
   <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\\begin\{verbatim\}\n</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_content'>content</span><span class='embexpr_end'>}</span><span class='tstring_content'>\n\\end\{verbatim\}\n</span><span class='tstring_end'>&quot;</span></span>
@@ -1733,30 +1815,30 @@ essentally no knoweldge of either other than their form.</p>
       <pre class="lines">
 
 
-576
-577
-578
-579
-580
-581
-582
-583
-584
-585
-586
-587
-588
-589
-590
-591
-592
-593
-594
-595
-596</pre>
+596
+597
+598
+599
+600
+601
+602
+603
+604
+605
+606
+607
+608
+609
+610
+611
+612
+613
+614
+615
+616</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 576</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 596</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_open_process'>open_process</span>
 
@@ -1951,13 +2033,13 @@ essentally no knoweldge of either other than their form.</p>
       <pre class="lines">
 
 
-682
-683
-684
-685</pre>
+702
+703
+704
+705</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 682</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 702</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_preamble_process'>preamble_process</span>
   <span class='comment'># &quot;\\begin\{preamble\}\n%% HO HO HO!\n#{self.content}\n\\end\{preamble\}\n&quot;
@@ -2033,19 +2115,19 @@ essentally no knoweldge of either other than their form.</p>
       <pre class="lines">
 
 
-545
-546
-547
-548
-549
-550
-551
-552
-553
-554</pre>
+565
+566
+567
+568
+569
+570
+571
+572
+573
+574</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 545</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 565</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_report'>report</span>
   <span class='comment'># Report on this node
@@ -2077,25 +2159,25 @@ essentally no knoweldge of either other than their form.</p>
       <pre class="lines">
 
 
-688
-689
-690
-691
-692
-693
-694
-695
-696
-697
-698
-699
-700
-701
-702
-703</pre>
+708
+709
+710
+711
+712
+713
+714
+715
+716
+717
+718
+719
+720
+721
+722
+723</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 688</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 708</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_sidebar_process'>sidebar_process</span>
   <span class='id identifier rubyid_title'>title</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_title'>title</span>
@@ -2287,12 +2369,12 @@ essentally no knoweldge of either other than their form.</p>
       <pre class="lines">
 
 
-541
-542
-543</pre>
+561
+562
+563</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 541</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 561</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_toc_process'>toc_process</span>
   <span class='comment'># warn &quot;Please implement me! (toc_process)&quot;.red if $VERBOSE
@@ -2317,13 +2399,13 @@ essentally no knoweldge of either other than their form.</p>
       <pre class="lines">
 
 
-705
-706
-707
-708</pre>
+725
+726
+727
+728</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 705</span>
+      <pre class="code"><span class="info file"># File 'lib/asciidoctor/latex/node_processors.rb', line 725</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_verse_process'>verse_process</span>
   <span class='comment'># $tex.env &#39;alltt&#39;, self.content
@@ -2339,9 +2421,9 @@ essentally no knoweldge of either other than their form.</p>
 </div>
 
     <div id="footer">
-  Generated on Tue May  3 13:31:56 2016 by
+  Generated on Tue Jun  7 05:32:26 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.7.6 (ruby-2.3.0).
+  0.8.7.6 (ruby-2.2.3).
 </div>
 
   </body>