Mapping language processing - Revision history

Mholmes at 17:13, 20 November 2020

2020-11-20T17:13:56Z

← Older revision		Revision as of 17:13, 20 November 2020
Line 14:		Line 14:
	- DOCUMENTATIONLANGUAGE=en (now deleted)		- 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		- lang

Mholmes at 17:06, 20 November 2020

2020-11-20T17:06:14Z

← Older revision		Revision as of 17:06, 20 November 2020
Line 7:		Line 7:
	==Input parameters==		==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		- ALLLANGUAGES=en
	- LANGUAGE=en		- LANGUAGE=en (now deleted)
	- INPUTLANGUAGE=en		- 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:		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>.		(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.''~~

	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.

	~~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.		[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.

Mholmes: /* Input parameters */

2020-11-06T17:39:56Z

Input parameters

← Older revision		Revision as of 17:39, 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 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.		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.

Mholmes: /* Input parameters */

2020-11-06T17:39:40Z

Input parameters

← Older revision		Revision as of 17:39, 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 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.		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.		[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.

Mholmes: /* Input parameters */

2020-11-06T17:39:17Z

Input parameters

← Older revision		Revision as of 17:39, 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 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.		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.		[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.

Mholmes: /* Input parameters */

2020-11-06T17:38:32Z

Input parameters

← 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.

Mholmes: /* Input parameters */

2020-11-06T17:37:44Z

Input parameters

← Older revision		Revision as of 17:37, 6 November 2020
Line 24:		Line 24:
	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. ~~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~~.		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		[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

Mholmes at 17:36, 6 November 2020

2020-11-06T17:36:10Z

← Older revision		Revision as of 17:36, 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 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. 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.		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		[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

Mholmes at 17:34, 6 November 2020

2020-11-06T17:34:23Z

← 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

Mholmes at 16:41, 6 November 2020

2020-11-06T16:41:04Z

← Older revision		Revision as of 16:41, 6 November 2020
Line 18:		Line 18:
	- lang		- lang
	- doclang		- 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>.

			LANGUAGE is a