release v0.11.0

Breaking changes:
- disable again mathMLSpacing option in MathJax due to poor results
- improve listings with line numbers (fix #25)
- only add --navigationtoc=context when using the GitBook style
- Docker container uses root again for compatibility with GitHub actions
- template GitHub workflow improvements

CSS/style.gitbook.scss

@@ -397,7 +397,8 @@ mjx-container[jax="SVG"][display="true"] {
   /* unset bookdown font size, restore spaces */
   &>pre>code {
     font-size: inherit;
-    white-space: pre;
+    white-space: normal;
+    display: block;
   }
 
   /* adjust position of download button */
@@ -406,6 +407,14 @@ mjx-container[jax="SVG"][display="true"] {
   }
 }
 
+/* typeset line numbers within container */
+.ltx_lst_numbers_left .ltx_listingline .ltx_tag {
+  position: initial;
+  display: inline-block;
+  margin-left: 0;
+  width: 1.7em;
+}
+
 .book .book-body .page-wrapper .page-inner section.normal {
   & code.ltx_lstlisting {
     font-size: inherit;

Dockerfile

@@ -146,4 +146,3 @@ EOF
 
 WORKDIR /source
 ENTRYPOINT ["/run-bookml"]
-USER ubuntu

XSLT/bookml-html5.xsl

@@ -90,12 +90,6 @@
       <xsl:text>&#x0A;</xsl:text>
       <script>
         MathJax = {
-          chtml: {
-            mathmlSpacing: true
-          },
-          svg: {
-            mathmlSpacing: true
-          },
           startup: {
             ready() {
               // do not process equations disabled with \bmlDisableMathJax (code suggested by Davide P. Cervone)

XSLT/proc-resources.xsl

@@ -22,13 +22,18 @@
   xmlns:ltx="http://dlmf.nist.gov/LaTeXML"
   exclude-result-prefixes="ltx">
 
+  <xsl:import href="utils.xsl"/>
+
   <xsl:output
     method="text"
     encoding="utf-8" />
 
   <xsl:param name="BML_TARGET" />
 
   <xsl:template match="/">
+    <xsl:if test="$BMLSTYLE='gitbook'">
+      <xsl:value-of select="$BML_TARGET" /><xsl:text>: LATEXMLPOSTAUTOFLAGS=--navigationtoc=context&#x0A;</xsl:text>
+    </xsl:if>
     <xsl:apply-templates select="//ltx:resource" />
   </xsl:template>
 

bookml.mk

@@ -1,4 +1,4 @@
-# BookML: bookdown flavoured GitBook port for LaTeXML
+# BookML: bookdown flavoured GitBook port for LaTeXML
 # Copyright (C) 2021-23 Vincenzo Mantova <[email protected]>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -26,7 +26,7 @@ SYNCTEX      ?= 5 # must produce *.synctex.gz
 LATEXML          ?= latexml
 LATEXMLPOST      ?= latexmlpost
 LATEXMLFLAGS     ?=
-LATEXMLPOSTFLAGS ?= --urlstyle=file --navigationtoc=context --sourcedirectory=.
+LATEXMLPOSTFLAGS ?= --urlstyle=file --sourcedirectory=.
 # (4) for *adding* options without changing the default ones
 LATEXMLEXTRAFLAGS     ?=
 LATEXMLPOSTEXTRAFLAGS ?= --pmml --mathtex
@@ -352,7 +352,7 @@ $(AUX_DIR)/html/%/index.html: $$(AUX_DIR)/xml/$$*.xml $$(BOOKML_DEPS_HTML) $$(wi
 	@$(if $(_recurse),,$(call bml.prog,latexmlpost: $*.xml → $*/index.html))
 	-@$(if $(_recurse),,$(call bml.cmd,$(RMDIR) $(call bml.ospath,$(AUX_DIR)/html/$*)))
 	@$(if $(_recurse),,$(call bml.cmd,$(LATEXMLPOST) $(if $(wildcard LaTeXML-html5.xsl),,--stylesheet=bookml/XSLT/bookml-html5.xsl) \
-	  $(if $(SPLITAT),--splitat=$(SPLITAT)) --xsltparameter=BMLSEARCH:yes $(LATEXMLPOSTFLAGS) $(LATEXMLPOSTEXTRAFLAGS) \
+	  $(if $(SPLITAT),--splitat=$(SPLITAT)) --xsltparameter=BMLSEARCH:yes $(LATEXMLPOSTAUTOFLAGS) $(LATEXMLPOSTFLAGS) $(LATEXMLPOSTEXTRAFLAGS) \
 	  --dbfile=$(AUX_DIR)/latexmlaux/"$*".LaTeXML.db --log="$(AUX_DIR)/latexmlaux/$*.latexmlpost.log" --destination="$@" "$<"))
 	@$(if $(_recurse),,$(call bml.cmd,$(PERL) bookml/search_index.pl "$(AUX_DIR)/html/$*"))
 

template/.github/workflows/bookml.yaml

@@ -7,13 +7,16 @@ jobs:
       - name: Check out LaTeX files
         uses: actions/checkout@v4
       - name: Compile with BookML
+        id: bookml
         # you may replace bookml with bookml-basic, bookml-small, bookml-medium to download fewer packages
         uses: docker://ghcr.io/vlmantova/bookml:latest
         with:
-          args: all aux-zip
+          args: -k all aux-zip # warning: aux-zip must be run *sequentially after* all
       - name: Upload outputs
+        if: ${{ always() }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          tag: ${{ github.ref_name }}
-          title: ${{ github.run_number }}
-        run: gh release create "${{ github.ref_name }}" --repo="$GITHUB_REPOSITORY" --title="build $title" --notes="${{ github.event.head_commit.message }}" --draft *.zip
+          notes: ${{ steps.bookml.outcome == 'cancelled' && '**The build was cancelled. Some outputs may be missing.** ' || ( steps.bookml.outcome == 'failure' && '**Parts of the build have failed. Consult the AUX file for more information.** ' || '' ) }}${{ github.event.head_commit.message }}
+          title: ${{ steps.bookml.outcome == 'cancelled' && 'cancelled' || ( steps.bookml.outcome == 'failure' && 'failed' || 'successful' ) }} build: ${{ github.event.head_commit.message }}
+          ref: ${{ github.ref_name }}
+        run: gh release create "$ref" --repo="$GITHUB_REPOSITORY" --title="$title" --notes="$notes" *.zip