deploy: 757568f

giellalt · Apr 12, 2024 · b6e0393 · b6e0393
1 parent 2b4d758
commit b6e0393
Show file tree

Hide file tree

Showing 13 changed files with 63 additions and 34 deletions.
diff --git a/Links.md b/Links.md
@@ -4,6 +4,7 @@
     * `fst/`
         * `morphology/`
             * `stems/`
+                * [rootStems.lexc](src-fst-morphology-stems-rootStems.lexc.html) ([src](https://github.com/giellalt/lang-epo/blob/main/src/fst/morphology/stems/rootStems.lexc))
         * `phonetics/`
             * [txt2ipa.xfscript](src-fst-phonetics-txt2ipa.xfscript.html) ([src](https://github.com/giellalt/lang-epo/blob/main/src/fst/phonetics/txt2ipa.xfscript))
         * `transcriptions/`
@@ -12,7 +13,6 @@
 * `tools/`
     * `grammarcheckers/`
         * [grammarchecker.cg3](tools-grammarcheckers-grammarchecker.cg3.html) ([src](https://github.com/giellalt/lang-epo/blob/main/tools/grammarcheckers/grammarchecker.cg3))
-            * `/`
     * `tokenisers/`
         * [tokeniser-disamb-gt-desc.pmscript](tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-disamb-gt-desc.pmscript))
         * [tokeniser-gramcheck-gt-desc.pmscript](tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-gramcheck-gt-desc.pmscript))

diff --git a/Makefile.in b/Makefile.in
@@ -250,6 +250,7 @@ GLANGUAGE = @GLANGUAGE@
 GRAMCHECKVERSION = @GRAMCHECKVERSION@
 GTCORE = @GTCORE@
 GTCORESH = @GTCORESH@
+GTGRAMTOOL = @GTGRAMTOOL@
 GTLANG = @GTLANG@
 GTLANG2 = @GTLANG2@
 GTLANGUAGE = @GTLANGUAGE@
@@ -940,7 +941,7 @@ regenerate-markdown: generate-markdown
 
 # Generate endpoint json file for shield.io lemma count badge.
 # Only to be stored in the gh-pages branch, ignored in main.
-$(srcdir)/lemmacount.json: $(top_srcdir)/src/fst/morphology/stems/*.lexc
+$(srcdir)/lemmacount.json:
 	$(AM_V_GEN)$(GTCORE)/scripts/make-lemmacount.json.sh $(abs_top_srcdir) > $@
 
 # Generate a maturity.json file as endpoint for the maturity badge.
@@ -978,9 +979,14 @@ $(foreach f,$(DOCSRC_XEROX),$(eval $(call make_md_files,$(f))))
 $(foreach f,$(DOCSRC_CG3),$(eval $(call make_md_files_cg3,$(f))))
 
 # Collect all target files into one big MD file:
+# Remove the VPATH prefix to create the header for each file/chapter:
 $(ALLINONE_MD_PAGE): $(VPATH_MDFILES)
-	$(AM_V_GEN)printf "# $(GLANGUAGE) description \n\nAll documents in one file\n\n" \
-	| cat - $(VPATH_MDFILES) > $@
+	$(AM_V_GEN)printf "# $(GLANGUAGE) language model documentation\n\nAll doc-comment documentation in one large file.\n" > $@
+	for f in $(VPATH_MDFILES); do \
+		header=$${f#"$(top_srcdir)/docs/"};\
+		printf "\n---\n\n# $$header \n\n" >> $@ ;\
+		cat $$f >> $@ ;\
+	done
 
 $(LINKS):
 	$(AM_V_GEN)for doc2md in $(DOCSRC_MDFILES) ; do \
@@ -994,27 +1000,42 @@ $(LINKS):
 		d2=`echo "$$d" | cut -d '/' -f 2` ;\
 		d3=`echo "$$d" | cut -d '/' -f 3` ;\
 		d4=`echo "$$d" | cut -d '/' -f 4` ;\
+		d5=`echo "$$d" | cut -d '/' -f 5` ;\
 		if test "x$$d1" != "x$$oldd1" ; then \
 			echo "* \`$$d1/\`" ;\
 			oldd1=$$d1 ;\
+			oldd2="";\
+			oldd3="";\
+			oldd4="";\
 		fi ; \
 		if test "x$$d2" = x ; then \
 			echo "    * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
 		elif test "x$$d2" != "x$$oldd2" ; then \
 			echo "    * \`$$d2/\`" ;\
 			oldd2=$$d2 ;\
+			oldd3="";\
+			oldd4="";\
+			oldd5="";\
 		fi ; \
 		if test "x$$d3" = x -a "x$$d2" != x; then \
 			echo "        * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
 		elif test "x$$d3" != "x$$oldd3" ; then \
 			echo "        * \`$$d3/\`" ;\
 			oldd3=$$d3 ;\
+			oldd4="";\
 		fi ; \
 		if test "x$$d4" = x -a "x$$d3" != x ; then \
 			echo "            * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
 		elif test "x$$d4" != "x$$oldd4" ; then \
 			echo "            * \`$$d4/\`" ;\
 			oldd4=$$d4 ;\
+			oldd5="";\
+		fi ; \
+		if test "x$$d5" = x -a "x$$d4" != x ; then \
+			echo "                * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
+		elif test "x$$d5" != "x$$oldd5" ; then \
+			echo "                * \`$$d5/\`" ;\
+			oldd5=$$d5 ;\
 		fi ; \
 	done > $@
 

diff --git a/epo.md b/epo.md
@@ -1,6 +1,10 @@
-# Esperanto description 
+# Esperanto language model documentation
 
-All documents in one file
+All doc-comment documentation in one large file.
+
+---
+
+# src-cg3-functions.cg3.md 
 
 
 
@@ -170,8 +174,15 @@ These were the set types.
 ## HNOUN MAPPING
 
 * * *
+
 <small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-epo/blob/main/src/cg3/functions.cg3)</small>
 
+---
+
+# src-fst-morphology-stems-rootStems.lexc.md 
+
+
+
 * rootStems.lexc Noun, Adj, Verb, Adv examples:*
 * *konstrua:* `konstru+R+Adj+Sing+Nom`
 * *konstruo:* `konstru+R+N+Sing+Nom`
@@ -188,6 +199,8 @@ These were the set types.
 
 ---
 
+# src-fst-phonetics-txt2ipa.xfscript.md 
+
 
 
 retroflex plosive, voiceless			t`  ʈ	    0288, 648 (` = ASCII 096)
@@ -355,6 +368,8 @@ retracted tongue root			_q
 
 ---
 
+# src-fst-transcriptions-transcriptor-abbrevs2text.lexc.md 
+
 
 
 We describe here how abbreviations are in Esperanto are read out, e.g.
@@ -375,6 +390,8 @@ For example:
 
 ---
 
+# src-fst-transcriptions-transcriptor-numbers-digit2text.lexc.md 
+
 
 
 % komma% :,      Root ;
@@ -389,6 +406,8 @@ For example:
 
 ---
 
+# tools-grammarcheckers-grammarchecker.cg3.md 
+
 
 [ L A N G U A G E ]  G R A M M A R   C H E C K E R
 
@@ -686,7 +705,14 @@ expression **WORD - premodifiers**.
 ### Grammarchecker sets
 
 * * *
-<small>This (part of) documentation was generated from [tools/grammarcheckers/grammarchecker.cg3](https://github.com/giellalt/lang-epo/blob/main/tools/grammarcheckers/grammarchecker.cg3)</small># Tokeniser for epo
+
+<small>This (part of) documentation was generated from [tools/grammarcheckers/grammarchecker.cg3](https://github.com/giellalt/lang-epo/blob/main/tools/grammarcheckers/grammarchecker.cg3)</small>
+
+---
+
+# tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.md 
+
+# Tokeniser for epo
 
 Usage:
 ```
@@ -750,6 +776,8 @@ Finally we mark as a token any sequence making up a:
 
 ---
 
+# tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.md 
+
 # Grammar checker tokenisation for epo
 
 Requires a recent version of HFST (3.10.0 / git revision>=3aecdbc)
@@ -813,6 +841,8 @@ Finally we mark as a token any sequence making up a:
 
 ---
 
+# tools-tokenisers-tokeniser-tts-cggt-desc.pmscript.md 
+
 # TTS tokenisation for smj
 
 Requires a recent version of HFST (3.10.0 / git revision>=3aecdbc)
@@ -874,6 +904,3 @@ Needs hfst-tokenise to output things differently depending on the tag they get
 * * *
 
 <small>This (part of) documentation was generated from [tools/tokenisers/tokeniser-tts-cggt-desc.pmscript](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-tts-cggt-desc.pmscript)</small>
-
----
-
diff --git a/index.md b/index.md
@@ -22,6 +22,7 @@ Below is an autogenerated list of documentation pages built from structured comm
     * `fst/`
         * `morphology/`
             * `stems/`
+                * [rootStems.lexc](src-fst-morphology-stems-rootStems.lexc.html) ([src](https://github.com/giellalt/lang-epo/blob/main/src/fst/morphology/stems/rootStems.lexc))
         * `phonetics/`
             * [txt2ipa.xfscript](src-fst-phonetics-txt2ipa.xfscript.html) ([src](https://github.com/giellalt/lang-epo/blob/main/src/fst/phonetics/txt2ipa.xfscript))
         * `transcriptions/`
@@ -30,7 +31,6 @@ Below is an autogenerated list of documentation pages built from structured comm
 * `tools/`
     * `grammarcheckers/`
         * [grammarchecker.cg3](tools-grammarcheckers-grammarchecker.cg3.html) ([src](https://github.com/giellalt/lang-epo/blob/main/tools/grammarcheckers/grammarchecker.cg3))
-            * `/`
     * `tokenisers/`
         * [tokeniser-disamb-gt-desc.pmscript](tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-disamb-gt-desc.pmscript))
         * [tokeniser-gramcheck-gt-desc.pmscript](tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-gramcheck-gt-desc.pmscript))

diff --git a/src-cg3-functions.cg3.md b/src-cg3-functions.cg3.md
@@ -166,4 +166,5 @@ These were the set types.
 ## HNOUN MAPPING
 
 * * *
-<small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-epo/blob/main/src/cg3/functions.cg3)</small>
+
+<small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-epo/blob/main/src/cg3/functions.cg3)</small>
diff --git a/src-fst-morphology-stems-rootStems.lexc.md b/src-fst-morphology-stems-rootStems.lexc.md
@@ -13,6 +13,3 @@
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/stems/rootStems.lexc](https://github.com/giellalt/lang-epo/blob/main/src/fst/morphology/stems/rootStems.lexc)</small>
-
----
-
diff --git a/src-fst-phonetics-txt2ipa.xfscript.md b/src-fst-phonetics-txt2ipa.xfscript.md
@@ -162,6 +162,3 @@ retracted tongue root			_q
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/phonetics/txt2ipa.xfscript](https://github.com/giellalt/lang-epo/blob/main/src/fst/phonetics/txt2ipa.xfscript)</small>
-
----
-
diff --git a/src-fst-transcriptions-transcriptor-abbrevs2text.lexc.md b/src-fst-transcriptions-transcriptor-abbrevs2text.lexc.md
@@ -15,6 +15,3 @@ For example:
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/transcriptions/transcriptor-abbrevs2text.lexc](https://github.com/giellalt/lang-epo/blob/main/src/fst/transcriptions/transcriptor-abbrevs2text.lexc)</small>
-
----
-
diff --git a/src-fst-transcriptions-transcriptor-numbers-digit2text.lexc.md b/src-fst-transcriptions-transcriptor-numbers-digit2text.lexc.md
@@ -9,6 +9,3 @@
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/transcriptions/transcriptor-numbers-digit2text.lexc](https://github.com/giellalt/lang-epo/blob/main/src/fst/transcriptions/transcriptor-numbers-digit2text.lexc)</small>
-
----
-
diff --git a/tools-grammarcheckers-grammarchecker.cg3.md b/tools-grammarcheckers-grammarchecker.cg3.md
@@ -295,4 +295,5 @@ expression **WORD - premodifiers**.
 ### Grammarchecker sets
 
 * * *
-<small>This (part of) documentation was generated from [tools/grammarcheckers/grammarchecker.cg3](https://github.com/giellalt/lang-epo/blob/main/tools/grammarcheckers/grammarchecker.cg3)</small>
+
+<small>This (part of) documentation was generated from [tools/grammarcheckers/grammarchecker.cg3](https://github.com/giellalt/lang-epo/blob/main/tools/grammarcheckers/grammarchecker.cg3)</small>
diff --git a/tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.md b/tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.md
@@ -59,6 +59,3 @@ Finally we mark as a token any sequence making up a:
 * * *
 
 <small>This (part of) documentation was generated from [tools/tokenisers/tokeniser-disamb-gt-desc.pmscript](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-disamb-gt-desc.pmscript)</small>
-
----
-
diff --git a/tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.md b/tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.md
@@ -58,6 +58,3 @@ Finally we mark as a token any sequence making up a:
 * * *
 
 <small>This (part of) documentation was generated from [tools/tokenisers/tokeniser-gramcheck-gt-desc.pmscript](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-gramcheck-gt-desc.pmscript)</small>
-
----
-
diff --git a/tools-tokenisers-tokeniser-tts-cggt-desc.pmscript.md b/tools-tokenisers-tokeniser-tts-cggt-desc.pmscript.md
@@ -59,6 +59,3 @@ Needs hfst-tokenise to output things differently depending on the tag they get
 * * *
 
 <small>This (part of) documentation was generated from [tools/tokenisers/tokeniser-tts-cggt-desc.pmscript](https://github.com/giellalt/lang-epo/blob/main/tools/tokenisers/tokeniser-tts-cggt-desc.pmscript)</small>
-
----
-