Fix basic builder aborting

If aux directory is specified, documents from sub directories are involved,
initial call of pdflatex may return non-zero exit status, as required
directories don't yet exist. Hence suppress aborting build process and create
them, manually, before continuing normally.

Author: deathaxe

docs/buildsystem.md

@@ -144,6 +144,8 @@ The `basic` builder is a simple, straight-forward build system, which simply run
 
 **Note:** To use `basic` builder set `"builder": "basic"` in sublime-build file or any of the supported settings.
 
+**Note:** Initial pdflatex call(s) may return with `error`, if required directories are to be created. Don't worry about it, that's normal behavior.
+
 Supported settings:
 
 - `bibtex` - the bibliography engine to use, if not explicitly requested by build process. Valid values are `biber`, `bibtex` or `bibtex8`.

plugins/builder/basic_builder.py

@@ -71,9 +71,11 @@ def commands(self) -> CommandGenerator:
 
         latex.append(self.tex_name)
 
+        # Initial pdflatex run may fail, if required diretories are not yet present
+        self.abort_on_error = False
         yield (latex, f"running {engine}...")
 
-        # Create required directories
+        # Create required directories and retry
         while matches := FILE_WRITE_ERROR_REGEX.findall(self.out):
             for path, _ in matches:
                 abspath = os.path.join(self.aux_directory_full or self.tex_dir, path)
@@ -82,6 +84,8 @@ def commands(self) -> CommandGenerator:
 
             yield (latex, f"running {engine}...")
 
+        self.abort_on_error = True
+
         # Check for citations
         # We need to run pdflatex twice after bibtex
         run_bibtex = False