Environment variables - Revision history

Moini: /* Environment variables specific to Inkscape */

2019-07-08T20:11:56Z

Environment variables specific to Inkscape

← Older revision		Revision as of 20:11, 8 July 2019
Line 10:		Line 10:
	; <code>INKSCAPE_DATADIR</code>		; <code>INKSCAPE_DATADIR</code>
	: Specifies a different location for the Inkscape data directory (i.e. the system folder where Inkscape looks for shared files).		: Specifies a different location for the Inkscape data directory (i.e. the system folder where Inkscape looks for shared files).
	: By default this equals to something like <tt>/usr/share/~~inkscape~~</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share</tt> (Windows).		: By default this equals to something like <tt>/usr/share/</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share</tt> (Windows).
	: Make sure there's a <tt>share/inkscape</tt> folder present in this location that contains system-wide Inkscape data like extensions, filters, gradients, icons, etc.		: Make sure there's a <tt>share/inkscape</tt> folder present in this location that contains system-wide Inkscape data like extensions, filters, gradients, icons, etc.
	; <code>INKSCAPE_LOCALEDIR</code>		; <code>INKSCAPE_LOCALEDIR</code>
	: Specifies a different location for the folder where Inkscape looks for the translation catalog (i.e. binary inkscape.mo files).		: Specifies a different location for the folder where Inkscape looks for the translation catalog (i.e. binary inkscape.mo files).
	: By default this equals to something like <tt>/share/locale</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share/locale</tt> (Windows).		: By default this equals to something like <tt>/usr/share/locale</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share/locale</tt> (Windows).
	<!--		<!--

Moini: /* Environment variables specific to Inkscape */

2019-07-08T20:00:28Z

Environment variables specific to Inkscape

← Older revision		Revision as of 20:00, 8 July 2019
Line 10:		Line 10:
	; <code>INKSCAPE_DATADIR</code>		; <code>INKSCAPE_DATADIR</code>
	: Specifies a different location for the Inkscape data directory (i.e. the system folder where Inkscape looks for shared files).		: Specifies a different location for the Inkscape data directory (i.e. the system folder where Inkscape looks for shared files).
	: By default this equals to something like <tt>/share</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share</tt> (Windows).		: By default this equals to something like <tt>/usr/share/inkscape</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share</tt> (Windows).
	: Make sure there's a <tt>share/inkscape</tt> folder present in this location that contains system-wide Inkscape data like extensions, filters, gradients, icons, etc.		: Make sure there's a <tt>share/inkscape</tt> folder present in this location that contains system-wide Inkscape data like extensions, filters, gradients, icons, etc.
	; <code>INKSCAPE_LOCALEDIR</code>		; <code>INKSCAPE_LOCALEDIR</code>

Patrick87: /* Inkscape */ use header formatting

2019-07-08T19:15:16Z

Inkscape: use header formatting

← Older revision		Revision as of 19:15, 8 July 2019
Line 3:		Line 3:
	== Inkscape ==		== Inkscape ==

	Environment variables specific to Inkscape:		=== Environment variables specific to Inkscape ===

	; <code>INKSCAPE_PROFILE_DIR</code>		; <code>INKSCAPE_PROFILE_DIR</code>
Line 27:		Line 27:
	-->		-->

	System-wide environment variables that directly affect Inkscape:		=== System-wide environment variables that directly affect Inkscape ===

	; <code>LANG</code>		; <code>LANG</code>

Patrick87: /* Inkscape */ add "LANG"

2019-07-08T19:14:42Z

Inkscape: add "LANG"

← Older revision		Revision as of 19:14, 8 July 2019
Line 26:		Line 26:

	-->		-->

			System-wide environment variables that directly affect Inkscape:

			; <code>LANG</code>
			: Sets the system locale (i.e. the language used by the system) and will override Inkscape's default interface language.
			: For example setting something like <code>LANG=fr_FR.UTF-8</code> will cause Inkscape to use French by default.

	== glib / gtk ==		== glib / gtk ==

Patrick87: Section for Python (PYTHONPATH)

2019-07-08T19:01:55Z

Section for Python (PYTHONPATH)

← Older revision		Revision as of 19:01, 8 July 2019
Line 40:		Line 40:

	A very helpful way to "debug" GUI issues (like fine-tuning CSS or inspecting the individual parts of the GUI and their properties) is the [https://blog.gtk.org/2017/04/05/the-gtk-inspector/ GTK Inspector]. It can be accessed by setting the environment variable <code>GTK_DEBUG=interactive</code>		A very helpful way to "debug" GUI issues (like fine-tuning CSS or inspecting the individual parts of the GUI and their properties) is the [https://blog.gtk.org/2017/04/05/the-gtk-inspector/ GTK Inspector]. It can be accessed by setting the environment variable <code>GTK_DEBUG=interactive</code>

			== Python ==

			Environment variables specific to Python:

			; <code>PYTHONPATH</code>
			: Allows you to add additional directories to the list of paths Python is searching for modules to load.
			: Usually there's no need to adjust this variable (Inkscape adds the system-wide extensions directory as well as the extensions directory in the user profile folder automatically). However if you're writing an extension and would like to load some modules from other locations this is an way to do this. Note that Inkscape will prepend the <code>PYTHONPATH</code> with the default module locations, so you can't use this method to override modules shipped with Inkscape.

Patrick87: Add section on glib / gtk

2019-07-08T18:53:53Z

Add section on glib / gtk

← Older revision		Revision as of 18:53, 8 July 2019
Line 15:		Line 15:
	: Specifies a different location for the folder where Inkscape looks for the translation catalog (i.e. binary inkscape.mo files).		: Specifies a different location for the folder where Inkscape looks for the translation catalog (i.e. binary inkscape.mo files).
	: By default this equals to something like <tt>/share/locale</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share/locale</tt> (Windows).		: By default this equals to something like <tt>/share/locale</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share/locale</tt> (Windows).

	<!--		<!--

Line 27:		Line 26:

	-->		-->

			== glib / gtk ==

			Environment variables specific to Inkscape's core libraries and GUI toolkit. For a full list, see
			* [https://developer.gnome.org/glib/stable/glib-running.html Running GLib Applications] and
			* [https://developer.gnome.org/gtk3/stable/gtk-running.html Running GTK+ Applications] respectively

			Particularly helpful for general debugging purposes are the environment variables that control debug output, namely glib's <code>G_MESSAGES_DEBUG</code> and gtk's <code>GTK_DEBUG</code>. Setting either of those to the special value <code>all</code> will print a lot of additional debug output to the console. Be aware that there will be ''a lot'' of output when using <code>all</code>, so you might want to fine-tune the debug options to only output information of relevant program components.

			To trace warnings and critical debug messages, the environment variable <code>G_DEBUG</code> can prove useful. Setting it's value to <code>fatal-warnings</code> causes glib to abort the program on all warnings, i.e. the first call to either of <code>g_warning()</code> and <code>g_critical()</code>. Setting it to <code>fatal-criticals</code> will only abort on calls to <code>g_critical()</code>.

			=== Visually debugging gtk ===

			A very helpful way to "debug" GUI issues (like fine-tuning CSS or inspecting the individual parts of the GUI and their properties) is the [https://blog.gtk.org/2017/04/05/the-gtk-inspector/ GTK Inspector]. It can be accessed by setting the environment variable <code>GTK_DEBUG=interactive</code>

Patrick87: Initial list of Inkscape environment variables

2019-07-08T18:24:45Z

Initial list of Inkscape environment variables

New page

This is a list of some helpful environment variables, that you can use to modify the behavior of Inkscape itself as well as of the libraries it uses.

== Inkscape ==

Environment variables specific to Inkscape:

; <code>INKSCAPE_PROFILE_DIR</code>
: Specifies a different location for the user profile directory (i.e. the folder where preferences and user data are saved).
: By default this equals to something like <tt>~/.config/inkscape</tt> (*nix) or <tt>%appdata%/inkscape</tt> (Windows)
; <code>INKSCAPE_DATADIR</code>
: Specifies a different location for the Inkscape data directory (i.e. the system folder where Inkscape looks for shared files).
: By default this equals to something like <tt>/share</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share</tt> (Windows).
: Make sure there's a <tt>share/inkscape</tt> folder present in this location that contains system-wide Inkscape data like extensions, filters, gradients, icons, etc.
; <code>INKSCAPE_LOCALEDIR</code>
: Specifies a different location for the folder where Inkscape looks for the translation catalog (i.e. binary inkscape.mo files).
: By default this equals to something like <tt>/share/locale</tt> (*nix) or <tt>%ProgramFiles%/Inkscape/share/locale</tt> (Windows).