cfgfile.rst 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. The Config File
  2. ===============
  3. All paths in the config file are relative to the directory where the config
  4. file is located, unless noted otherwise.
  5. Application section
  6. -------------------
  7. .. describe:: name
  8. The user-readable name of your application. This will be used for various
  9. display purposes in the installer, and for shortcuts and the folder in
  10. 'Program Files'.
  11. .. describe:: version
  12. The version number of your application.
  13. .. describe:: script
  14. Path to the Python script which launches your application.
  15. .. describe:: icon (optional)
  16. Path to a ``.ico`` file to be used for shortcuts to your application. pynsis
  17. has a default generic icon, but you probably want to replace it.
  18. .. _cfg_python:
  19. Python section
  20. --------------
  21. .. describe:: version
  22. The Python version to download and bundle with your application. At present,
  23. this needs to be at least ``3.3.0``.
  24. .. describe:: bitness (optional)
  25. ``32`` or ``64``, to use 32-bit (x86) or 64-bit (x64) Python. On Windows, this
  26. defaults to the version you're using, so that compiled modules will match. On
  27. other platforms, it defaults to 32-bit.
  28. Include section
  29. ---------------
  30. .. describe:: packages (optional)
  31. A list of importable package and module names to include in the installer.
  32. Specify only top-level packages, i.e. without a ``.`` in the name.
  33. .. describe:: files (optional)
  34. Extra files to be installed with your application.
  35. Build section
  36. -------------
  37. .. describe:: directory (optional)
  38. The build directory. Defaults to ``build/nsis/``.
  39. .. describe:: installer_name (optional)
  40. The filename of the installer, relative to the build directory. The default
  41. is made from your application name and version.