Split the BUILD of //docs (#649)

regisd · web-flow · commit 170197a6b81e · 2019-12-03T23:57:42.000+01:00
* Split BUILD file for //docs/md
diff --git a/docs/BUILD b/docs/BUILD
@@ -2,32 +2,13 @@
 
 load("@bazel_pandoc//:pandoc.bzl", "pandoc")
 load("@bazel_latex//:latex.bzl", "latex_document")
-load(":docs.bzl", "jflex_doc_tex", "replace_placeholders")
-
-GENRULE_CONCATENATE = "cat $(SRCS) > $@"
-
-DOC_SECTIONS = [
-    "intro",
-    "installing",
-    "maven-plugin",
-    "ant-task",
-    "example",
-    "lex-specs",
-    "encodings",
-    "performance",
-    "porting-and-parsers",
-    "end",
-]
-
-MD_SRCS = ["md/head.md"] + ["md/" + src + ".md" for src in DOC_SECTIONS]
-
-TEX_SRCS = [":" + section + "_tex" for section in DOC_SECTIONS]
+load("//docs:docs.bzl", "DOC_SECTIONS", "replace_placeholders")
 
 # TODO(regisd) Add `output` attribute
 # https://github.com/ProdriveTechnologies/bazel-pandoc/pull/1
 pandoc(
     name = "html",
-    src = ":manual_md",
+    src = "//docs/md:concatenated_md",
     from_format = "markdown",
     # TODO: Add "--css manual.css" when the rule accepts data files
     #
@@ -39,31 +20,21 @@ pandoc(
     to_format = "html",
 )
 
-replace_placeholders(
-    name = "manual_md",
-    src = ":concatenated_manual",
-)
-
-# Concatenates all pages in a single document.
-genrule(
-    name = "concatenated_manual",
-    srcs = MD_SRCS,
-    outs = ["concatenated_manual.md"],
-    cmd = GENRULE_CONCATENATE,
-)
+TEX_SRCS = ["//docs/md:" + section + "_tex" for section in DOC_SECTIONS]
 
 latex_document(
     name = "manual",
     srcs = [
         ":fig/jflex-black.png",
         ":first_page",
         ":latex_content",
+    ] + TEX_SRCS + [
         "@bazel_latex//packages:geometry",
         "@bazel_latex//packages:graphicx",
         "@bazel_latex//packages:hyperref",
         "@bazel_latex//packages:microtype",
         "@bazel_latex//packages:upquote",
-    ] + TEX_SRCS,
+    ],
     main = "manual_full.tex",
 )
 
@@ -74,13 +45,10 @@ replace_placeholders(
     output_to_bindir = True,  # that's where pdf_latex looks into
 )
 
-# Generates :section_tex (with substituted variables)
-[jflex_doc_tex(name = section) for section in DOC_SECTIONS]
-
 genrule(
     name = "latex_content",
     srcs = TEX_SRCS,
     outs = ["_content.tex"],
-    cmd = "echo '" + ("\n".join(["\\input{docs/" + section + "_tex}" for section in DOC_SECTIONS])) + "' > $@",
+    cmd = "echo '" + ("\n".join(["\\input{docs/md/" + section + "_tex}" for section in DOC_SECTIONS])) + "' > $@",
     output_to_bindir = True,  # that's where pdf_latex looks into
 )
diff --git a/docs/docs.bzl b/docs/docs.bzl
@@ -8,6 +8,19 @@ RELEASE_DATE = "21 September 2018"
 
 UNICODE_VER = "12.0"
 
+DOC_SECTIONS = [
+    "intro",
+    "installing",
+    "maven-plugin",
+    "ant-task",
+    "example",
+    "lex-specs",
+    "encodings",
+    "performance",
+    "porting-and-parsers",
+    "end",
+]
+
 def replace_placeholders(name, src = "", out = None, **kwargs):
     """Replaces placeholders by their respective value."""
     if not out:
@@ -23,20 +36,3 @@ def replace_placeholders(name, src = "", out = None, **kwargs):
               " $< > $@",
         **kwargs
     )
-
-def jflex_doc_tex(name, src = None):
-    """Generates the tex for a section"""
-    if not src:
-        src = "md/" + name + ".md"
-    pandoc(
-        name = name + "_tex",
-        src = ":" + name + "_md",
-        from_format = "markdown",
-        to_format = "latex",
-        options = ["--biblatex"],
-    )
-
-    replace_placeholders(
-        name = name + "_md",
-        src = src,
-    )
diff --git a/docs/md/BUILD b/docs/md/BUILD
@@ -0,0 +1,30 @@
+load("@bazel_pandoc//:pandoc.bzl", "pandoc")
+load("//docs:docs.bzl", "DOC_SECTIONS", "replace_placeholders")
+
+ALL_SECTIONS = ["head"] + DOC_SECTIONS
+
+GENRULE_CONCATENATE = "cat $(SRCS) > $@"
+
+[replace_placeholders(
+    name = section + "_md",
+    src = section + ".md",
+) for section in ALL_SECTIONS]
+
+# Concatenates all pages in a single document.
+genrule(
+    name = "concatenated_md",
+    srcs = [":%s_md" % section for section in ALL_SECTIONS],
+    outs = ["concatenated_manual.md"],
+    cmd = GENRULE_CONCATENATE,
+    visibility = ["//docs:__pkg__"],
+)
+
+# Generates :section_tex (with substituted variables)
+[pandoc(
+    name = section + "_tex",
+    src = ":" + section + "_md",
+    from_format = "markdown",
+    options = ["--biblatex"],
+    to_format = "latex",
+    visibility = ["//docs:__pkg__"],
+) for section in DOC_SECTIONS]
diff --git a/docs/md/head.md b/docs/md/head.md
@@ -7,8 +7,8 @@ bibliography: manual.bib
 
 The Fast Lexical Analyser Generator
 
-Copyright © 1998–2018 by 
-[Gerwin Klein](http://www.doclsf.de), Steve Rowe, and 
+Copyright © 1998–2019 by 
+[Gerwin Klein](http://www.doclsf.de/), Steve Rowe, and 
 [Régis Décamps](http://regis.decamps.info/).
 
 Version $VERSION, $RELEASE_DATE
