IGNFileFormat - Revision history

Octalot: Default blacklist is used for access to all files

2024-09-14T09:48:12Z

Default blacklist is used for access to all files

← Older revision		Revision as of 09:48, 14 September 2024
Line 3:		Line 3:

	If you would prefer to have more control over which files and directories should be ignored, you should provide a <b>_server.ign</b> file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server.		If you would prefer to have more control over which files and directories should be ignored, you should provide a <b>_server.ign</b> file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server.

			{{DevFeature1.13\|12}} The engine blocks WML and Lua from accessing any file that matches the built-in list. This was added as a security feature to block access to .git directories, disregards any _server.ign file, and is likely to change during the 1.19 dev cycle (see discussion in [https://github.com/wesnoth/wesnoth/pull/9325 PR 9325]).

	== Where do I put the file, and what goes in it? ==		== Where do I put the file, and what goes in it? ==

Mathemagician: /* _server.ign does NOT implicitly include the defaults */

2019-12-21T12:35:35Z

_server.ign does NOT implicitly include the defaults

← Older revision		Revision as of 12:35, 21 December 2019
Line 44:		Line 44:
	*.project		*.project

	If ~~there is~~ a custom _server.ign ~~file~~, ~~the contents of the file are used in addition~~ to ~~the defaults listed here~~.		If you create a custom _server.ign, you should add these entries to it.

	== See Also ==		== See Also ==

Shiki: changed markup of '?' to match the one used by the other wildcards

2018-03-27T13:03:11Z

changed markup of '?' to match the one used by the other wildcards

← Older revision		Revision as of 13:03, 27 March 2018
Line 12:		Line 12:
	* {{DevFeature1.13\|0}}: Blank lines and lines beginning with '<code># </code>' (space required) are ignored.		* {{DevFeature1.13\|0}}: Blank lines and lines beginning with '<code># </code>' (space required) are ignored.
	* Each line should contain exactly one pattern.		* Each line should contain exactly one pattern.
	* <code></code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code></code> stands for any number of any characters).		* <code></code> and <code>?</code> wildcards are supported (<code>?</code> stands for any single character, <code></code> stands for any number of any characters).
	* {{DevFeature1.13\|12}}: <code>+</code> wildcards are also supported: it stands for one or more characters.		* {{DevFeature1.13\|12}}: <code>+</code> wildcards are also supported: it stands for one or more characters.
	* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.		* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.

Jyrkive: Slight changes

2018-03-17T14:53:45Z

Slight changes

← Older revision		Revision as of 14:53, 17 March 2018
Line 13:		Line 13:
	* Each line should contain exactly one pattern.		* Each line should contain exactly one pattern.
	* <code></code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code></code> stands for any number of any characters).		* <code></code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code></code> stands for any number of any characters).
	* {{DevFeature1.13\|12}}: <code>+</code> wildcards are also supported: it stands for one or more ~~character~~.		* {{DevFeature1.13\|12}}: <code>+</code> wildcards are also supported: it stands for one or more characters.
	* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.		* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.

Line 20:		Line 20:
	If there is no custom _server.ign file present, a default filter will be used instead, which is as follows:		If there is no custom _server.ign file present, a default filter will be used instead, which is as follows:

	.*		.+
	.*/		.+/
	__MACOSX/		__MACOSX/
	#*#		#*#

Jyrkive: Add the + wildcard

2018-03-17T12:06:16Z

Add the + wildcard

← Older revision		Revision as of 12:06, 17 March 2018
Line 13:		Line 13:
	* Each line should contain exactly one pattern.		* Each line should contain exactly one pattern.
	* <code></code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code></code> stands for any number of any characters).		* <code></code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code></code> stands for any number of any characters).
			* {{DevFeature1.13\|12}}: <code>+</code> wildcards are also supported: it stands for one or more character.
	* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.		* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.

Shiki: /* Default values */ Clarified that as of today the default _server.ign is not overridden but extended

2018-03-08T17:38:56Z

Default values: Clarified that as of today the default _server.ign is not overridden but extended

← Older revision		Revision as of 17:38, 8 March 2018
Line 17:		Line 17:
	==== Default values ====		==== Default values ====

	If there is no custom _server.ign file present, a default filter will be used instead, which ~~as of Wesnoth 1.12~~ is as follows:		If there is no custom _server.ign file present, a default filter will be used instead, which is as follows:

	.*		.*
Line 38:		Line 38:
	*.vbs		*.vbs
	*.o		*.o
			*.ini {{DevFeature1.13\|12}}
	Thumbs.db		Thumbs.db
	*.wesnoth		*.wesnoth
	*.project		*.project

	If there is a custom _server.ign file, the contents of the file are used ~~as the filter '''instead''' of~~ the defaults~~, so you should include any of the applicable default exclusions patterns in your own file as well~~.		If there is a custom _server.ign file, the contents of the file are used in addition to the defaults listed here.

	== See Also ==		== See Also ==

Aquileia: Use `for code snippets (except '?' which looks awkward)`


2015-12-03T13:35:47Z
Use <code> for code snippets (except '?' which looks awkward)

				
				
				
				
				
				← Older revision
				Revision as of 13:35, 3 December 2015
				
Line 10:
Line 10:
A specific format is required: A specific format is required:



* {{DevFeature1.13|0}}: Blank lines and lines beginning with '# ' (space required) are ignored. * {{DevFeature1.13|0}}: Blank lines and lines beginning with '<code># </code>' (space required) are ignored.
* Each line should contain exactly one pattern. * Each line should contain exactly one pattern.
* <b>*</b> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <b>*</b> stands for any number of any characters). * <code>*</code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code>*</code> stands for any number of any characters).
* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files. * Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.



==== Default values ==== ==== Default values ====
Line 42:
Line 42:
  *.project   *.project



If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.   If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.



== See Also == == See Also ==



Aquileia: Update for commit 24d46b7a744
2015-04-08T00:26:57Z
Update for commit 24d46b7a744

				
				
				
				
				
				← Older revision
				Revision as of 00:26, 8 April 2015
				
Line 10:
Line 10:
A specific format is required: A specific format is required:



* Each line should contain exactly one pattern and nothing else. * {{DevFeature1.13|0}}: Blank lines and lines beginning with '# ' (space required) are ignored.
* Each line should contain exactly one pattern.
* <b>*</b> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <b>*</b> stands for any number of any characters). * <b>*</b> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <b>*</b> stands for any number of any characters).
* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files. * Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.
Line 42:
Line 43:



If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.   If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.  

== See Also ==

* [[PblWML]]



[[Category:Create]] [[Category:Create]]



Aquileia: __MACOSX is a directory ignore rule
2015-03-18T19:29:25Z
__MACOSX is a directory ignore rule

				
				
				
				
				
				← Older revision
				Revision as of 19:29, 18 March 2015
				
Line 20:
Line 20:
  .*   .*
  .*/   .*/
  __MACOSX   __MACOSX/
  #*#   #*#
  *~   *~



Vultraz at 16:51, 17 December 2014
2014-12-17T16:51:56Z


				
				
				
				
				
				← Older revision
				Revision as of 16:51, 17 December 2014
				
Line 4:
Line 4:
If you would prefer to have more control over which files and directories should be ignored, you should provide a <b>_server.ign</b> file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server. If you would prefer to have more control over which files and directories should be ignored, you should provide a <b>_server.ign</b> file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server.



== Where do I put the file? == == Where do I put the file, and what goes in it? ==



The file should be placed within the root level of your add-on (<code>data/add-ons/addon_name/_server.ign</code>). The file should be placed within the root level of your add-on (<i>data/add-ons/addon_name/_server.ign</i>).



== What goes into the file? == A specific format is required:



* Each line should contain exactly one pattern and nothing else. * Each line should contain exactly one pattern and nothing else.
Line 14:
Line 14:
* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files. * Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.



=== Default values === ==== Default values ====



If there is no custom _server.ign file present, a default filter will be used instead, which as of Wesnoth 1.12 is as follows: If there is no custom _server.ign file present, a default filter will be used instead, which as of Wesnoth 1.12 is as follows:

← Older revision		Revision as of 13:35, 3 December 2015
Line 10:		Line 10:
	A specific format is required:		A specific format is required:

	* {{DevFeature1.13\|0}}: Blank lines and lines beginning with '# ' (space required) are ignored.		* {{DevFeature1.13\|0}}: Blank lines and lines beginning with '<code># </code>' (space required) are ignored.
	* Each line should contain exactly one pattern.		* Each line should contain exactly one pattern.
	* <b></b> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <b></b> stands for any number of any characters).		* <code></code> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <code></code> stands for any number of any characters).
	* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.		* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.

	==== Default values ====		==== Default values ====
Line 42:		Line 42:
	*.project		*.project

	If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.		If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.

	== See Also ==		== See Also ==

← Older revision		Revision as of 00:26, 8 April 2015
Line 10:		Line 10:
	A specific format is required:		A specific format is required:

	* Each line should contain exactly one pattern ~~and nothing else~~.		* {{DevFeature1.13\|0}}: Blank lines and lines beginning with '# ' (space required) are ignored.
			* Each line should contain exactly one pattern.
	* <b></b> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <b></b> stands for any number of any characters).		* <b></b> and <b>?</b> wildcards are supported (<b>?</b> stands for any single character, <b></b> stands for any number of any characters).
	* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.		* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.
Line 42:		Line 43:

	If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.		If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.

			== See Also ==

			* [[PblWML]]

	[[Category:Create]]		[[Category:Create]]

← Older revision		Revision as of 19:29, 18 March 2015
Line 20:		Line 20:
	.*		.*
	.*/		.*/
	__MACOSX		__MACOSX/
	#*#		#*#
	*~		*~

← Older revision		Revision as of 16:51, 17 December 2014
Line 4:		Line 4:
	If you would prefer to have more control over which files and directories should be ignored, you should provide a <b>_server.ign</b> file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server.		If you would prefer to have more control over which files and directories should be ignored, you should provide a <b>_server.ign</b> file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server.

	== Where do I put the file? ==		== Where do I put the file, and what goes in it? ==

	The file should be placed within the root level of your add-on (<~~code~~>data/add-ons/addon_name/_server.ign</~~code~~>).		The file should be placed within the root level of your add-on (<i>data/add-ons/addon_name/_server.ign</i>).

	~~== What goes into the file? ==~~		A specific format is required:

	* Each line should contain exactly one pattern and nothing else.		* Each line should contain exactly one pattern and nothing else.
Line 14:		Line 14:
	* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.		* Patterns with a trailing forward slash (<b>/</b>) will match directories; the rest only match files.

	=== Default values ===		==== Default values ====

	If there is no custom _server.ign file present, a default filter will be used instead, which as of Wesnoth 1.12 is as follows:		If there is no custom _server.ign file present, a default filter will be used instead, which as of Wesnoth 1.12 is as follows:

IGNFileFormat - Revision history

Octalot: Default blacklist is used for access to all files

Mathemagician: /* _server.ign does NOT implicitly include the defaults */

Shiki: changed markup of '?' to match the one used by the other wildcards

Jyrkive: Slight changes

Jyrkive: Add the + wildcard

Shiki: /* Default values */ Clarified that as of today the default _server.ign is not overridden but extended

Aquileia: Use for code snippets (except '?' which looks awkward)

Aquileia: Update for commit 24d46b7a744

Aquileia: __MACOSX is a directory ignore rule

Vultraz at 16:51, 17 December 2014

Aquileia: Use `for code snippets (except '?' which looks awkward)`