SymbolsDialog - Revision history

Zearin: Fix markup ordering from my last edit (pre/code to code/pre)

2017-01-15T17:40:29Z

Fix markup ordering from my last edit (pre/code to code/pre)

← Older revision		Revision as of 17:40, 15 January 2017
Line 73:		Line 73:
	* Generic symbols: It should be possible to extend the Symbol dialog to include <code><g></code> elements as well as <code><symbol></code> elements. A group could be marked as a symbol by adding an <code><inkscape:symbol></code> tag. In this way one can put place holders in for things like text:		* Generic symbols: It should be possible to extend the Symbol dialog to include <code><g></code> elements as well as <code><symbol></code> elements. A group could be marked as a symbol by adding an <code><inkscape:symbol></code> tag. In this way one can put place holders in for things like text:

	<~~pre~~><~~code~~>		<code><pre>
	<g role="inkscape:symbol">		<g role="inkscape:symbol">
	<symbol id="wrapperBox">...</symbol>		<symbol id="wrapperBox">...</symbol>
	<text id="label">...</text>		<text id="label">...</text>
	</g>		</g>
	</~~code~~></~~pre~~>		</pre></code>

	* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.		* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.

	[[Category:Dialogs]]		[[Category:Dialogs]]

Zearin: Markup and minor text tweaks

2017-01-15T17:39:37Z

Markup and minor text tweaks

← Older revision		Revision as of 17:39, 15 January 2017
Line 4:		Line 4:
	== Features ==		== Features ==

	Allows copying and pasting symbols (<symbol> elements) from both the document being edited and from symbol libraries.		Allows copying and pasting symbols (<code><symbol></code> elements) from both the document being edited and from symbol libraries.

	== Use ==		== Use ==

	* Open ''Symbol dialog'':		* Open ''Symbol dialog'':
	** Object -> Symbol dialog..., or		** Object ▶︎ Symbol dialog..., or
	** Ctrl-Shift-Y. (Note, the shortcut was used for Edit->Undo. I am guessing that this shortcut is pretty unused.)		** <kbd>Ctrl-Shift-Y</kbd>. (Note, the shortcut was used for Edit ▶︎ Undo. I am guessing that this shortcut is pretty unused.)

	* Select symbol set		* Select symbol set
Line 17:		Line 17:
	* Copy and paste by		* Copy and paste by
	** Click on symbol to copy to clipboard		** Click on symbol to copy to clipboard
	** Paste (Ctrl-V) to document.		** Paste (<kbd>Ctrl-V</kbd>) to document.

	== Symbol Libraries ==		== Symbol Libraries ==

	Symbol libraries are sets of symbols located in one SVG document. Inkscape will look for libraries in the ''share/symbols'' directories (both system and personal). Any <symbol> elements defined in the <defs> section will be picked up. (<symbol> elements are allowed anywhere in an SVG document according to the spec, but Inkscape seems to have some trouble if they are not in the <defs> section.)		Symbol libraries are sets of symbols located in one SVG document. Inkscape will look for libraries in the ''share/symbols'' directories (both system and personal). Any <code><symbol></code> elements defined in the <code><defs></code> section will be picked up. (<code><symbol></code> elements are allowed anywhere in an SVG document according to the spec, but Inkscape seems to have some trouble if they are not in the <code><defs></code> section.)

	In order to allow styling of symbols from within Inkscape, styling should be kept out of <symbol> elements as much as possible. It is then possible for a symbol to inherit the styling of the <use> element that ~~references it. In order to provide a default style to~~ a <symbol> one can ~~either provide a general default style in the root <svg> element of the library~~ or add a symbol specific default style by putting a style string in the "inkscape:symbol-style" attribute inside the symbol element. When a symbol is selected in the Symbol dialog, the style will be added to the <use> element in the ~~clipboard~~.		Note that since a symbol library is an ordinary SVG file, one can also include documentation and/or sample diagrams in the same file.

	~~Note that as a symbol library is an ordinary SVG file~~, one ~~can also include documentation~~ and/~~or sample diagrams in the same file~~.		There are two sample sets of symbols, one with Logic symbols and with AIGA/DOT transportation symbols.

	~~There are two sample sets~~ of symbols, one ~~with Logic~~ symbols ~~and with AIGA~~/~~DOT transportation~~ symbols.		=== Symbols and Styles ===

			In order to allow styling of symbols from within Inkscape, styling should be kept out of <code><symbol></code> elements as much as possible. It is then possible for a symbol to inherit the styling of the <code><use></code> element that references it. In order to provide a default style to a <code><symbol></code> one can either provide a general default style in the root <svg> element of the library or add a symbol specific default style by putting a style string in the <code>inkscape:symbol-style</code> attribute inside the <code><symbol></code> element. When a symbol is selected in the Symbol dialog, the style will be added to the <code><use></code> element in the clipboard.

			=== Other Sources of Symbols ===

			Visio stencil files (<code>.vss</code>) can also be used as a source of symbols by dropping the files into the ''share/symbols'' directory (if libvisio has been linked in).

	~~Visio stencil files (.vss) can also be used as a source of symbols by dropping the files into the ''share/symbols'' directory (if libvisio has been linked in).~~

	== Editing Symbols ==		== Editing Symbols ==
Line 36:		Line 41:
	Two commands are available to allow editing of symbols from within Inkscape:		Two commands are available to allow editing of symbols from within Inkscape:

	* '''Object->Symbol to Group''':		* '''Object ▶︎ Symbol to Group''':

	This converts the <symbol> referenced by the selected <use> element to a group located in the untransformed position of the symbol. The new group is left selected. Any <use> element (clone) that referenced the symbol should be left referencing the group. No default styling is applied to the group itself (since there is no <use> element to inherit it from).		This converts the <code><symbol></code> referenced by the selected <code><use></code> element to a group located in the untransformed position of the symbol. The new group is left selected. Any <code><use></code> element (clone) that referenced the symbol should be left referencing the group. No default styling is applied to the group itself (since there is no <code><use></code> element to inherit it from).

	* '''Object->Group to Symbol'''		* '''Object ▶︎ Group to Symbol'''

	This converts a selected group to a <symbol> element. No <use> element is created. Any <use> elements that referenced the group will now reference the symbol. The new symbol can be selected in the Symbol dialog in the ''Current Document'' Symbol set. (You may need to unselect and then reselect the ''Current Document'' set to get the symbol to show.)		This converts a selected group to a <code><symbol></code> element. No <code><use></code> element is created. Any <code><use></code> elements that referenced the group will now reference the symbol. The new symbol can be selected in the Symbol dialog in the ''Current Document'' Symbol set. (You may need to unselect and then reselect the ''Current Document'' set to get the symbol to show.)

	A lot of alternative ways were tried to be able to round-trip symbols to groups and back. This method seemed the most ~~straight forward~~ and avoids issues with transforms and styling.		A lot of alternative ways were tried to be able to round-trip symbols to groups and back. This method seemed the most straightforward and avoids issues with transforms and styling.

	Copying (Ctrl-C) and then pasting a symbol, or duplicating a symbol creates a new <use> element (clone) referencing the same symbol.		Copying (<kbd>Ctrl-C</kbd>) and then pasting a symbol, or duplicating a symbol creates a new <code><use></code> element (clone) referencing the same symbol.

	To copy a <symbol> for creating a new <symbol>, first convert the symbol to a group, copy the group, edit the copied group, and convert both groups back to symbols (give the new group a useful "id" and "title~~" using~~ the Object Properties dialog).		To copy a <code><symbol></code> for creating a new <code><symbol></code>, first convert the symbol to a group, copy the group, edit the copied group, and convert both groups back to symbols (give the new group useful <code>id</code> and <code>title</code> attributes via the Object Properties dialog).

	=== Current implementation in 0.91 ===		=== Current implementation in 0.91 ===
Line 66:		Line 71:
	== Future Enhancements ==		== Future Enhancements ==

	* Generic symbols: It should be possible to extend the Symbol dialog to include <g> elements as well as <symbol> elements. A group could be marked as a symbol by adding an "inkscape:symbol" tag. In this way one can put place holders in for things like text:		* Generic symbols: It should be possible to extend the Symbol dialog to include <code><g></code> elements as well as <code><symbol></code> elements. A group could be marked as a symbol by adding an <code><inkscape:symbol></code> tag. In this way one can put place holders in for things like text:

	<pre>		<pre><code>
	<g role="inkscape:symbol">		<g role="inkscape:symbol">
	<symbol id="wrapperBox">...</symbol>		<symbol id="wrapperBox">...</symbol>
	<text id="label">...</text>		<text id="label">...</text>
	</g>		</g>
	</pre>		</code></pre>

	* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.		* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.

	[[Category:Dialogs]]		[[Category:Dialogs]]

~suv: /* Editing Symbols */

2015-02-09T14:57:32Z

Editing Symbols

← Older revision		Revision as of 14:57, 9 February 2015
Line 52:		Line 52:
	=== Current implementation in 0.91 ===		=== Current implementation in 0.91 ===

	The implementation of this feature was later changed (TODO: update with detailed description for current status in 0.91).		The implementation of this feature was later changed (TODO: update with detailed description for current status in 0.91 - Bug #[https://bugs.launchpad.net/inkscape/+bug/1419345 1419345]).

	== Bugs/Issues ==		== Bugs/Issues ==

~suv: /* Editing Symbols */ needs update, see e.g. bug #1419345 and questions asked elsewhere

2015-02-09T14:52:18Z

Editing Symbols: needs update, see e.g. bug #1419345 and questions asked elsewhere

← Older revision		Revision as of 14:52, 9 February 2015
Line 33:		Line 33:
	== Editing Symbols ==		== Editing Symbols ==

			=== Original Draft & Implementation ===
	Two commands are available to allow editing of symbols from within Inkscape:		Two commands are available to allow editing of symbols from within Inkscape:

Line 47:		Line 48:
	Copying (Ctrl-C) and then pasting a symbol, or duplicating a symbol creates a new <use> element (clone) referencing the same symbol.		Copying (Ctrl-C) and then pasting a symbol, or duplicating a symbol creates a new <use> element (clone) referencing the same symbol.

	To copy a <symbol> for creating a new <symbol>, first convert the symbol to a group, copy the group, edit the copied group, and convert both groups back to symbols (give the new group a useful "id" and "title" using the Object Properties dialog).		To copy a <symbol> for creating a new <symbol>, first convert the symbol to a group, copy the group, edit the copied group, and convert both groups back to symbols (give the new group a useful "id" and "title" using the Object Properties dialog).

			=== Current implementation in 0.91 ===

			The implementation of this feature was later changed (TODO: update with detailed description for current status in 0.91).

	== Bugs/Issues ==		== Bugs/Issues ==

Doctormo at 16:30, 21 April 2013

2013-04-21T16:30:38Z

← Older revision		Revision as of 16:30, 21 April 2013
Line 58:		Line 58:
	* Symbols referring to external elements (gradients, etc.) probably won't work.		* Symbols referring to external elements (gradients, etc.) probably won't work.
	* Symbols can have their own viewbox, this has not been tested.		* Symbols can have their own viewbox, this has not been tested.
	* Inkscape gives the <use> element linking to a symbols a width and height of 1. This is incorrect and leads to rendering errors in other SVG renderers. Width and height (as well as x and y) should not be set unless explicitly given. This needs to be fixed. A work-around is to set overflow="visible" in a <symbol>. ([https://bugs.launchpad.net/inkscape/+bug/1107924 Bug #1107924])
	* "GLib-CRITICAL **: g_strsplit: assertion `string != NULL' failed" error occur often.

	== Future Enhancements ==		== Future Enhancements ==

Doctormo at 21:17, 19 April 2013

2013-04-19T21:17:14Z

← Older revision		Revision as of 21:17, 19 April 2013
Line 51:		Line 51:
	== Bugs/Issues ==		== Bugs/Issues ==

			* Full list of Symbols Bugs: [https://bugs.launchpad.net/inkscape/+bugs?field.tag=symbols Launchpad Bug List]
	* Switching Desktop should switch Document Symbol set. (At the moment this is not an issue as each desktop gets its own Symbol dialog.)		* Switching Desktop should switch Document Symbol set. (At the moment this is not an issue as each desktop gets its own Symbol dialog.)
	* Symbol to Group/Group to Symbol should trigger an update to the symbols shown in the Symbol dialog when symbol set ''Current Document'' is selected.		* Symbol to Group/Group to Symbol should trigger an update to the symbols shown in the Symbol dialog when symbol set ''Current Document'' is selected.

~suv: /* Bugs/Issues */ add link to bug report

2013-01-30T01:06:38Z

Bugs/Issues: add link to bug report

← Older revision		Revision as of 01:06, 30 January 2013
Line 57:		Line 57:
	* Symbols referring to external elements (gradients, etc.) probably won't work.		* Symbols referring to external elements (gradients, etc.) probably won't work.
	* Symbols can have their own viewbox, this has not been tested.		* Symbols can have their own viewbox, this has not been tested.
	* Inkscape gives the <use> element linking to a symbols a width and height of 1. This is incorrect and leads to rendering errors in other SVG renderers. Width and height (as well as x and y) should not be set unless explicitly given. This needs to be fixed. A work-around is to set overflow="visible" in a <symbol>.		* Inkscape gives the <use> element linking to a symbols a width and height of 1. This is incorrect and leads to rendering errors in other SVG renderers. Width and height (as well as x and y) should not be set unless explicitly given. This needs to be fixed. A work-around is to set overflow="visible" in a <symbol>. ([https://bugs.launchpad.net/inkscape/+bug/1107924 Bug #1107924])
	* "GLib-CRITICAL **: g_strsplit: assertion `string != NULL' failed" error occur often.		* "GLib-CRITICAL **: g_strsplit: assertion `string != NULL' failed" error occur often.

Romain2Boss: Add Dialogs Category

2012-12-26T14:33:42Z

Add Dialogs Category

← Older revision		Revision as of 14:33, 26 December 2012
Line 72:		Line 72:

	* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.		* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.

			[[Category:Dialogs]]

Tavmjong: /* Symbol Libraries */

2012-12-25T17:46:00Z

Symbol Libraries

← Older revision		Revision as of 17:46, 25 December 2012
Line 27:		Line 27:
	Note that as a symbol library is an ordinary SVG file, one can also include documentation and/or sample diagrams in the same file.		Note that as a symbol library is an ordinary SVG file, one can also include documentation and/or sample diagrams in the same file.

	There ~~is a~~ sample ~~set~~ of Logic symbols.		There are two sample sets of symbols, one with Logic symbols and with AIGA/DOT transportation symbols.

			Visio stencil files (.vss) can also be used as a source of symbols by dropping the files into the ''share/symbols'' directory (if libvisio has been linked in).

	== Editing Symbols ==		== Editing Symbols ==

John.Smith: /* Use */

2012-11-30T08:05:13Z

Use

← Older revision		Revision as of 08:05, 30 November 2012
Line 8:		Line 8:
	== Use ==		== Use ==

	*Open ''Symbol dialog'':		* Open ''Symbol dialog'':
	** Object -> Symbol dialog..., or		** Object -> Symbol dialog..., or
	** Ctrl-Shift-Y. (Note, the shortcut was used for Edit->Undo. I am guessing that this shortcut is pretty unused.)		** Ctrl-Shift-Y. (Note, the shortcut was used for Edit->Undo. I am guessing that this shortcut is pretty unused.)

	*Select symbol set.		* Select symbol set

	*Click on symbol to copy to clipboard ~~(drag and drop not yet implemented).~~		* Drag and drop symbol into document, or
			* Copy and paste by
	*Paste (Ctrl-V) to document.		** Click on symbol to copy to clipboard
			** Paste (Ctrl-V) to document.

	== Symbol Libraries ==		== Symbol Libraries ==