WIP fix build

Author: garfieldnate

docs/soar_manual/build.sh

@@ -41,37 +41,43 @@ pandoc \
 
 echo "Generated initial PDF with index commands"
 
-# Run makeindex to generate the index file
-echo "Running makeindex on SoarManual.idx"
-cd output && makeindex SoarManual.idx && cd ..
-echo "Makeindex completed"
+# Check if index file was generated and run makeindex if needed
+if [ -f "output/SoarManual.idx" ]; then
+    echo "Index entries found, running makeindex..."
+    cd output && makeindex SoarManual.idx && cd ..
+    echo "Makeindex completed"
 
-echo "Starting second pandoc run to include index"
+    echo "Starting second pandoc run to include index"
 
-# Run pandoc again to include the index in the final PDF
-pandoc \
-    --pdf-engine=lualatex \
-    --resource-path=docs/soar_manual/ \
-    --template=docs/soar_manual/template.tex \
-    --listings \
-    --number-sections \
-    --lua-filter=docs/soar_manual/path_filter.lua \
-    --lua-filter=docs/soar_manual/index_filter.lua \
-    -V geometry:"left=3cm, top=2.5cm, right=3cm, bottom=3cm" \
-    -V has-index \
-    docs/soar_manual/01_Introduction.md \
-    docs/soar_manual/02_TheSoarArchitecture.md \
-    docs/soar_manual/03_SyntaxOfSoarPrograms.md \
-    docs/soar_manual/04_ProceduralKnowledgeLearning.md \
-    docs/soar_manual/05_ReinforcementLearning.md \
-    docs/soar_manual/06_SemanticMemory.md \
-    docs/soar_manual/07_EpisodicMemory.md \
-    docs/soar_manual/08_SpatialVisualSystem.md \
-    docs/soar_manual/09_SoarUserInterface.md \
-    output/cli.tex \
-    -o output/SoarManual.pdf
+    # Run pandoc again to include the index in the final PDF
+    pandoc \
+        --pdf-engine=lualatex \
+        --resource-path=docs/soar_manual/ \
+        --template=docs/soar_manual/template.tex \
+        --listings \
+        --number-sections \
+        --lua-filter=docs/soar_manual/path_filter.lua \
+        --lua-filter=docs/soar_manual/index_filter.lua \
+        -V geometry:"left=3cm, top=2.5cm, right=3cm, bottom=3cm" \
+        -V has-index \
+        docs/soar_manual/01_Introduction.md \
+        docs/soar_manual/02_TheSoarArchitecture.md \
+        docs/soar_manual/03_SyntaxOfSoarPrograms.md \
+        docs/soar_manual/04_ProceduralKnowledgeLearning.md \
+        docs/soar_manual/05_ReinforcementLearning.md \
+        docs/soar_manual/06_SemanticMemory.md \
+        docs/soar_manual/07_EpisodicMemory.md \
+        docs/soar_manual/08_SpatialVisualSystem.md \
+        docs/soar_manual/09_SoarUserInterface.md \
+        output/cli.tex \
+        -o output/SoarManual.pdf
+
+    echo "Generated final PDF with index"
+else
+    echo "No index entries found, skipping makeindex and second pandoc run"
+fi
 
-echo "Generated PDF successfully"
+echo "PDF generation completed"
 
 # Clean up the temporary CLI file
 if [ -f "output/cli.tex" ]; then

docs/soar_manual/index_filter.lua

@@ -2,16 +2,17 @@
 -- This allows index entries to be hidden from MkDocs while being processed for PDF output
 
 function extractIndexFromComments(elem)
-    if elem.tag == "RawInline" and elem.format == "html" then
+    -- Handle both RawInline and RawBlock elements
+    if (elem.tag == "RawInline" or elem.tag == "RawBlock") and elem.format == "html" then
         local comment = elem.text
         -- Match HTML comments containing \index commands
-        local index_cmd = comment:match("<!%-%-.-%\\index{(.-)}.-->")
+        local index_cmd = comment:match("<!%-%-%s*\\index{(.-)}.-->")
         if index_cmd then
             -- Return LaTeX raw inline instead of HTML comment
             return pandoc.RawInline("latex", "\\index{" .. index_cmd .. "}")
         end
-        -- Match full \index{...} commands in comments
-        local full_index = comment:match("<!%-%-.-(%\\index{.-}).--->")
+        -- Match full \index{...} commands in comments (allowing spaces)
+        local full_index = comment:match("<!%-%-%s*(%\\index{.-})%s*-->")
         if full_index then
             return pandoc.RawInline("latex", full_index)
         end
@@ -21,6 +22,7 @@ end
 
 return {
     {
-        RawInline = extractIndexFromComments
+        RawInline = extractIndexFromComments,
+        RawBlock = extractIndexFromComments
     }
 }