Mapping language processing - Revision history

Mholmes at 17:13, 20 November 2020

2020-11-20T17:13:56Z

Mholmes at 17:06, 20 November 2020

2020-11-20T17:06:14Z

Mholmes: /* Input parameters */

2020-11-06T17:39:56Z

‎Input parameters

Mholmes: /* Input parameters */

2020-11-06T17:39:40Z

‎Input parameters

Mholmes: /* Input parameters */

2020-11-06T17:39:17Z

‎Input parameters

Mholmes: /* Input parameters */

2020-11-06T17:38:32Z

‎Input parameters

Mholmes: /* Input parameters */

2020-11-06T17:37:44Z

‎Input parameters

Mholmes at 17:36, 6 November 2020

2020-11-06T17:36:10Z

Mholmes at 17:34, 6 November 2020

2020-11-06T17:34:23Z

Mholmes at 16:41, 6 November 2020

2020-11-06T16:41:04Z

@@ Line 14: / Line 14: @@
   - DOCUMENTATIONLANGUAGE=en (now deleted)
-ALLLANGUAGES is a parameter which can take multiple values, space-separated; for each of those values, a separate version of the Guidelines will be built in its own folder by using the ant macro <code>buildweb</code>. This calls the Stylesheets <code>utilties/Guidelines.xsl</code>, passing the current value of the language in all three of the following parameters:
+ALLLANGUAGES is a parameter which can take multiple values, space-separated; for each of those values, a separate version of the Guidelines will be built in its own folder by using the ant macro <code>buildweb</code>. This calls the Stylesheets <code>Utilities/Guidelines.xsl</code>, passing the current value of the language in all three of the following parameters:
   - lang

@@ Line 7: / Line 7: @@
 ==Input parameters==
-The Guidelines Makefile provides the following set of parameters related to language processing when building the Guidlines:
+The Guidelines Makefile originally provided the following set of parameters related to language processing when building the Guidelines:
   - ALLLANGUAGES=en
-  - LANGUAGE=en
+  - LANGUAGE=en (now deleted)
   - INPUTLANGUAGE=en
-  - DOCUMENTATIONLANGUAGE=en
+  - DOCUMENTATIONLANGUAGE=en (now deleted)
 ALLLANGUAGES is a parameter which can take multiple values, space-separated; for each of those values, a separate version of the Guidelines will be built in its own folder by using the ant macro <code>buildweb</code>. This calls the Stylesheets <code>utilties/Guidelines.xsl</code>, passing the current value of the language in all three of the following parameters:
@@ Line 21: / Line 21: @@
 (These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.
 INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[1] setting the variable DRIVER to this file. As far as we can tell, the only effect of this is to copy the Images directory from the language subdirectory to the output directory.
 [1]:P5/Source/en/Guidelines-en.xml or P5/Source/fr/Guidelines-fr.xml are the only two available right now, and the French chapter points only to English source files anyway, because the French header chapter is out of date and will not build.

@@ Line 22: / Line 22: @@
 (These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.
-LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. ''We recommend deleting this confusing parameter''
+LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. ''We recommend deleting this confusing parameter.''
 INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[1] setting the variable DRIVER to this file. As far as we can tell, the only effect of this is to copy the Images directory from the language subdirectory to the output directory.

@@ Line 22: / Line 22: @@
 (These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.
-LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. ""We recommend deleting this confusing parameter""
+LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. ''We recommend deleting this confusing parameter''
 INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[1] setting the variable DRIVER to this file. As far as we can tell, the only effect of this is to copy the Images directory from the language subdirectory to the output directory.
-DOCUMENTATIONLANGUAGE does not get used at all as far as we can see. ""We recommend deleting this confusing parameter.""
+DOCUMENTATIONLANGUAGE does not get used at all as far as we can see. ''We recommend deleting this confusing parameter.''
 [1]:P5/Source/en/Guidelines-en.xml or P5/Source/fr/Guidelines-fr.xml are the only two available right now, and the French chapter points only to English source files anyway, because the French header chapter is out of date and will not build.

@@ Line 22: / Line 22: @@
 (These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.
-LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. _We recommend deleting this confusing parameter._
+LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. ""We recommend deleting this confusing parameter""
 INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[1] setting the variable DRIVER to this file. As far as we can tell, the only effect of this is to copy the Images directory from the language subdirectory to the output directory.
-DOCUMENTATIONLANGUAGE does not get used at all as far as we can see. _We recommend deleting this confusing parameter._
+DOCUMENTATIONLANGUAGE does not get used at all as far as we can see. ""We recommend deleting this confusing parameter.""
 [1]:P5/Source/en/Guidelines-en.xml or P5/Source/fr/Guidelines-fr.xml are the only two available right now, and the French chapter points only to English source files anyway, because the French header chapter is out of date and will not build.

← Older revision		Revision as of 17:38, 6 November 2020
Line 26:		Line 26:
	INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[1] setting the variable DRIVER to this file. As far as we can tell, the only effect of this is to copy the Images directory from the language subdirectory to the output directory.		INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[1] setting the variable DRIVER to this file. As far as we can tell, the only effect of this is to copy the Images directory from the language subdirectory to the output directory.

−	[1]:P5/Source/en/Guidelines-en.xml or P5/Source/fr/Guidelines-fr.xml are the only two available right now, and the French chapter points only to English source files anyway, because the French header chapter is out of date and will not build	+	DOCUMENTATIONLANGUAGE does not get used at all as far as we can see. _We recommend deleting this confusing parameter._
		+
		+	[1]:P5/Source/en/Guidelines-en.xml or P5/Source/fr/Guidelines-fr.xml are the only two available right now, and the French chapter points only to English source files anyway, because the French header chapter is out of date and will not build.

← Older revision		Revision as of 17:34, 6 November 2020
Line 22:		Line 22:
	(These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.		(These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.

−	LANGUAGE is a	+	LANGUAGE is an apparently unused parameter; it appears in both the P5/Makefile and the P5/Test/Makefile, but is never used in either. We recommend deleting this confusing parameter.
		+
		+	INPUTLANGUAGE governs which source tree for the Guidelines specifically is used; it governs the name of the source file,[^1] setting the variable DRIVER to this file. That makes the root language effectively the input language, and then when other language versions are built in the <code>html-web.stamp</code> target, they are based on the input language rather than the default (en), assuming they are different.
		+
		+	[^1]:P5/Source/en/Guidelines-en.xml or P5/Source/fr/Guidelines-fr.xml are the only two available right now, and the French chapter points only to English source files anyway, because the French header chapter is out of date and will not build

@@ Line 18: / Line 18: @@
   - lang
   - doclang
-  - documenationLanguage
+  - documentationLanguage
-(These will be documented later.)
+(These will be documented later.) This parameter is automatically set to the following list of languages for a number of Makefile targets, including <code>teiwebsiteguidelines</code>.