Difference between revisions of "IGNFileFormat"

From The Battle for Wesnoth Wiki
(How does this works?: Updated to 1.10, fixed grammar, changed format to allow easier copy & paste)
m (_server.ign does NOT implicitly include the defaults)
 
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== .ign files ==
+
__NOTOC__
 +
When you upload an add-on, some files and directories are ignored and not uploaded.
  
=== What is an .ign file? ===
+
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.
When you upload an addon, some files/directory are ignored and not uploaded.
 
If you want to configure more closely which files/directories should be ignored, you need an .ign file.
 
  
=== What goes into an .ign file? ===
+
== Where do I put the file, and what goes in it? ==
The file format is one entry per line.
 
* ''*'' and ''?'' wildcards are supported (? mean any character, * mean any number of any character)
 
* Directories are identified by a trailing ''/''
 
  
=== Where do I put the .ign file? ===
+
The file should be placed within the root level of your add-on (<i>data/add-ons/addon_name/_server.ign</i>).
2 Solutions :
 
* put ''campaignname''.ign next to the ''campaignname''.pbl and ''campaignname''.cfg (old style)
 
* put a _server.ign next into the campaign directory (new style)
 
  
=== How does this work? ===
+
A specific format is required:
If there is no file, the default filter as of Wesnoth 1.10 is:
 
  
  .*
+
* {{DevFeature1.13|0}}: Blank lines and lines beginning with '<code># </code>' (space required) are ignored.
  .*/
+
* Each line should contain exactly one pattern.
  __MACOSX
+
* <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.
 +
* Patterns with a trailing forward slash '<code>/</code>' will match directories; the rest only match files.
 +
 
 +
==== Default values ====
 +
 
 +
If there is no custom _server.ign file present, a default filter will be used instead, which is as follows:
 +
 
 +
  .+
 +
  .+/
 +
  __MACOSX/
 
  #*#
 
  #*#
 
  *~
 
  *~
Line 36: Line 38:
 
  *.js
 
  *.js
 
  *.vbs
 
  *.vbs
  *o
+
  *.o
 +
*.ini  {{DevFeature1.13|12}}
 
  Thumbs.db
 
  Thumbs.db
 
  *.wesnoth
 
  *.wesnoth
 
  *.project
 
  *.project
  
If there is an .ign file the filter is the content of the file. Each file or directory matching any entry of the .ign file will not be uploaded to the add-ons server.
+
If you create a custom _server.ign, you should add these entries to it.
 +
 
 +
== See Also ==
 +
 
 +
* [[PblWML]]
  
 
[[Category:Create]]
 
[[Category:Create]]

Latest revision as of 12:35, 21 December 2019

When you upload an add-on, some files and directories are ignored and not uploaded.

If you would prefer to have more control over which files and directories should be ignored, you should provide a _server.ign 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, and what goes in it?

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

A specific format is required:

  • (Version 1.13.0 and later only): Blank lines and lines beginning with '# ' (space required) are ignored.
  • Each line should contain exactly one pattern.
  • * and ? wildcards are supported (? stands for any single character, * stands for any number of any characters).
  • (Version 1.13.12 and later only): + wildcards are also supported: it stands for one or more characters.
  • Patterns with a trailing forward slash '/' will match directories; the rest only match files.

Default values

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

.+
.+/
__MACOSX/
#*#
*~
*-bak
*.swp
*.pbl
*.ign
_info.cfg
*.exe
*.bat
*.cmd
*.com
*.scr
*.sh
*.js
*.vbs
*.o
*.ini  (Version 1.13.12 and later only)
Thumbs.db
*.wesnoth
*.project

If you create a custom _server.ign, you should add these entries to it.

See Also

This page was last edited on 21 December 2019, at 12:35.