Islint - Revision history

Tsingi at 14:38, 27 September 2009

2009-09-27T14:38:35Z

← Older revision		Revision as of 14:38, 27 September 2009
Line 7:		Line 7:
	= Contents =		= Contents =

	[./islint-implementation]		* [http://wiki.inkscape.org/wiki/index.php/Islint-implementation islint implementation]

Tsingi: /* Contents */

2009-09-27T14:35:27Z

Contents

← Older revision		Revision as of 14:35, 27 September 2009
Line 7:		Line 7:
	= Contents =		= Contents =

	[[islint-implementation]]		[./islint-implementation]

Tsingi: Replaced content with 'These are notes on islint requirements and implementation. islint is an SVG a profiling filter found at [https://sourceforge.net/projects/islint/ sourceforge] This page lin...'

2009-09-27T14:32:21Z

Replaced content with 'These are notes on islint requirements and implementation. islint is an SVG a profiling filter found at [https://sourceforge.net/projects/islint/ sourceforge] This page lin...'

← Older revision		Revision as of 14:32, 27 September 2009
Line 4:		Line 4:

	This page links from [http://wiki.inkscape.org/wiki/index.php/Save_Cleaned_SVG Save_Cleaned_SVG]		This page links from [http://wiki.inkscape.org/wiki/index.php/Save_Cleaned_SVG Save_Cleaned_SVG]

			= Contents =

	[[islint-implementation]]		[[islint-implementation]]

	~~== Wiki Notes Annotated ==~~

	I don't agree with some of the assumptions in these notes. I suspect that that's because I have different use cases for SVG than the person who wrote them. Sometimes it's hard to be objective in these matters. It would be good to have developers from different disciplines take a look at this list in order to get a useful generic set of requirements.

	~~'''''In italics is a copy of the '''Cleaning Operations''' list from the [http://wiki.inkscape.org/wiki/index.php/Save_Cleaned_SVG Save_Cleaned_SVG] page'''''~~

	~~Notes are formatted like this. ''Status, difficulty, priority like this''.~~

	~~=== Specify a limit to the precision of all positional elements. ===~~
	''DONE v0.8''. Trimming precision was my first priority. precision can be set to -1 (off) or 0..9. islint gives an extra decimal to transformation floats, so if you set prec=1, a matrix will have values to two decimal places. This is to preserve a little sanity at a low cost should there be nested transforms.
	~~=== Clean up XML Elements ===~~
	* '''''Collapse multiple redundant groups'''''
	~~''Not done, easy, low priority''.~~
	* '''''Remove empty tags, such as defs or metadata.'''''
	~~''Not done, easy, low priority''.~~
	* '''''Remove id tags for elements not referenced'''''
	''Not done, easy, low priority''. I like to have an id on everything. I usually want something more useful than path1234, but that requires either human intervention, or a targeted generator. I can add it as an option.
	~~=== Clean up Definitions ===~~
	''Not done, moderate, low priority''. Generally I think this section needs a bit of work. I don't use InkScape for gradients much, but I could. InkScape creates a lot of gradients and creates and references linear gradients when it needs a radial gradient. It is possible to do a lot of cleanup here.
	* '''''Remove unused definitions'''''
	* '''''Remove duplicate gradient stops'''''
	* '''''Collapse duplicate gradient definitions'''''
	* '''''Remove gradients that are only referenced by one other gradient'''''
	~~=== Clean up CSS ===~~
	islint implements inline CSS style sheets by parsing the style attributes (style=) into a table removing defaults, merging them, substituting class attributes, and finally, creating an inline style sheet. ''At the moment it does nothing with standalone XML attributes'' (stroke=, fill=) Currently I do not READ CSS tables or files for updating. This is a '''''HIGH PRIORITY''''' I like to use external CSS, it makes projects easy to adapt. ''If I can read in inline style sheets or external css files, I can carry along a naming convention in the style sheet.'' I need to know more about the InkScape plugin interface before I can implement separate CSS files. Perhaps a two stage operation? 1. profile the document, 2, save and reference the style sheet?
	: So, I have implemented one method of styling, possibly the most difficult one. Certainly the one I find most useful. This is done in the first pass of the document, gathering up all the styling. Writing the styling is done dead last, after all other manipulations have completed.
	~~: It would be easy to convert to all style attributes, or standalone XML attributes instead of an inline style sheet.~~

	* '''''Remove Default values, i.e. opacity: 1;'''''
	~~''DONE v0.8''.~~
	* '''''Remove Not applicable values, i.e. opacity: 0; fill-color: #00000;'''''
	~~Not sure what is meant here.~~
	* '''''Convert RGB colours from RGB(r,g,b) to #RRGGBB format'''''
	~~''Not done, easy, med priority''.~~

	~~''DONE v0.8''. I convert everything to rgb(...) because I like it for programmability and the CSS DOM seems to like them.~~
	* '''''Convert RGB colours from #RRGGBB to #RGB if possible'''''
	~~''Not done, easy, med priority''.~~

	~~=== Clean up paths ===~~
	''DONE v0.8'' (my way) What isn't mentioned here, and is fully implemented in islint, is recovering, circles, ellipses, lines, polylines and polygons. islint parses 'd' attributes into path segments, analyzes them, converts if possible, else puts them back together being very stingy with white space. A large effort was put forth here, so the code is in good shape for further reduction operations on paths. The sodipodi namespace data makes it possible to recover circles and arcs.
	* '''''Detect vertical/horizontal lines and replace.'''''
	~~''Not done, easy, high priority''.~~
	* '''''Eliminate empty path segments'''''
	~~''Not done, easy, high priority''. I didn't know there were any.~~
	* '''''Eliminate last segment in a polygon'''''
	~~''Not done, easy, high priority''.~~
	* '''''Collapse straight curves.'''''
	~~''Not done, ???, med priority''.~~
	* '''''Convert absolute path segments to relative ones.'''''
	~~''Not done, easy, high priority''.~~
	~~=== Process Transformations ===~~
	~~Do not understand these first two points, process Beziers how? Collapse transforms how?~~
	* '''''Process quadratic Bezier curves'''''
	* '''''Collapse all group based transformations'''''
	* '''''Convert known properties to element attributes'''''
	~~If this means convert the css properties in style attributes to standalone XML attributes (fill=, stroke=), see ''[http://wiki.inkscape.org/wiki/index.php/Islint#Clean_up_CSS Clean up CSS]'' above.~~
	* '''''css to element attributes'''''
	~~see ''[http://wiki.inkscape.org/wiki/index.php/Islint#Clean_up_CSS Clean up CSS]'' above.~~

	~~=== Output Standard SVG ===~~
	''DONE v0.8''. islint removes all namespaces it has not been told to keep. It is possible to tell it to preserve foreign namespaces by adding them through an option. Currently only possible via the command line interface.
	* '''''Remove inkscape namespace'''''
	* '''''Remove sodipodi namespace'''''
	* '''''Remove adobe namespace'''''
	* '''''Use viewPort instead of document width/height'''''
	~~''Not done, difficult, medium priority''. There many many ways to specify the document extent in SVG. Some analysis needs to be done before attempting to automate this.~~

	~~== Implementation Notes ==~~

	~~I'll keep track of what I do, am doing here. v0.8 is the version as of this writing.~~

	~~=== CSS Styling v0.8 ===~~

	~~Currently islint either creates inline CSS style sheets, or leaves styling alone. Only style attributes are processed.~~
	* TODO:
	** parse XML style attributes (stroke=, fill=)
	** implement options for document styling:
	*** CSS (inline or external)
	*** style attributes
	*** standalone XML attributes



	~~--[[User:Tsingi\|Tsingi]] 12:29, 24 September 2009 (UTC)~~

Tsingi at 14:30, 27 September 2009

2009-09-27T14:30:01Z

← Older revision		Revision as of 14:30, 27 September 2009
Line 5:		Line 5:
	This page links from [http://wiki.inkscape.org/wiki/index.php/Save_Cleaned_SVG Save_Cleaned_SVG]		This page links from [http://wiki.inkscape.org/wiki/index.php/Save_Cleaned_SVG Save_Cleaned_SVG]

			[[islint-implementation]]

	== Wiki Notes Annotated ==		== Wiki Notes Annotated ==

Tsingi: /* Implementation Notes */

2009-09-24T14:30:55Z

Implementation Notes

← Older revision		Revision as of 14:30, 24 September 2009
Line 76:		Line 76:
	== Implementation Notes ==		== Implementation Notes ==

	I'll keep track of what I do here. v0.8 is the version as of this writing.		I'll keep track of what I do, am doing here. v0.8 is the version as of this writing.

	=== CSS Styling v0.8 ===		=== CSS Styling v0.8 ===

Tsingi: /* Output Standard SVG */

2009-09-24T12:58:14Z

Output Standard SVG

← Older revision		Revision as of 12:58, 24 September 2009
Line 73:		Line 73:
	* '''''Use viewPort instead of document width/height'''''		* '''''Use viewPort instead of document width/height'''''
	''Not done, difficult, medium priority''. There many many ways to specify the document extent in SVG. Some analysis needs to be done before attempting to automate this.		''Not done, difficult, medium priority''. There many many ways to specify the document extent in SVG. Some analysis needs to be done before attempting to automate this.

			== Implementation Notes ==

			I'll keep track of what I do here. v0.8 is the version as of this writing.

			=== CSS Styling v0.8 ===

			Currently islint either creates inline CSS style sheets, or leaves styling alone. Only style attributes are processed.
			* TODO:
			** parse XML style attributes (stroke=, fill=)
			** implement options for document styling:
			*** CSS (inline or external)
			*** style attributes
			*** standalone XML attributes



	--[[User:Tsingi\|Tsingi]] 12:29, 24 September 2009 (UTC)		--[[User:Tsingi\|Tsingi]] 12:29, 24 September 2009 (UTC)

Tsingi: /* Output Standard SVG */

2009-09-24T12:49:13Z

Output Standard SVG

← Older revision		Revision as of 12:49, 24 September 2009
Line 67:		Line 67:

	=== Output Standard SVG ===		=== Output Standard SVG ===
	''DONE v0.8''. islint removes all namespaces it has not been told to keep. It is possible to tell it to preserve foreign namespaces by adding them through an option.		''DONE v0.8''. islint removes all namespaces it has not been told to keep. It is possible to tell it to preserve foreign namespaces by adding them through an option. Currently only possible via the command line interface.
	* '''''Remove inkscape namespace'''''		* '''''Remove inkscape namespace'''''
	* '''''Remove sodipodi namespace'''''		* '''''Remove sodipodi namespace'''''

Tsingi at 12:48, 24 September 2009

2009-09-24T12:48:18Z

Tsingi at 12:37, 24 September 2009

2009-09-24T12:37:30Z

← Older revision		Revision as of 12:37, 24 September 2009
Line 2:		Line 2:

	islint is an SVG a profiling filter found at [https://sourceforge.net/projects/islint/ sourceforge]		islint is an SVG a profiling filter found at [https://sourceforge.net/projects/islint/ sourceforge]

			This page links from [http://wiki.inkscape.org/wiki/index.php/Save_Cleaned_SVG Save_Cleaned_SVG]

Tsingi at 12:33, 24 September 2009

2009-09-24T12:33:54Z

← Older revision		Revision as of 12:33, 24 September 2009
Line 1:		Line 1:

	These are notes on islint requirements and implementation.		These are notes on islint requirements and implementation.

	islint is an SVG a profiling filter found at [https://sourceforge.net/projects/islint/ sourceforge]		islint is an SVG a profiling filter found at [https://sourceforge.net/projects/islint/ sourceforge]

	=== Wiki Notes Annotated ===
			== Wiki Notes Annotated ==

	I don't agree with some of the assumptions in these notes. I suspect that that's because I have different use cases for SVG than the person who wrote them. Sometimes it's hard to be objective in these matters. It would be good to have developers from different disciplines take a look at this list in order to get a useful generic set of requirements.		I don't agree with some of the assumptions in these notes. I suspect that that's because I have different use cases for SVG than the person who wrote them. Sometimes it's hard to be objective in these matters. It would be good to have developers from different disciplines take a look at this list in order to get a useful generic set of requirements.

← Older revision		Revision as of 12:48, 24 September 2009
Line 15:		Line 15:

	=== Specify a limit to the precision of all positional elements. ===		=== Specify a limit to the precision of all positional elements. ===
	''DONE''. Trimming precision was my first priority. precision can be set to -1 (off) or 0..9. islint gives an extra decimal to transformation floats, so if you set prec=1, a matrix will have values to two decimal places. This is to preserve a little sanity at a low cost should there be nested transforms.		''DONE v0.8''. Trimming precision was my first priority. precision can be set to -1 (off) or 0..9. islint gives an extra decimal to transformation floats, so if you set prec=1, a matrix will have values to two decimal places. This is to preserve a little sanity at a low cost should there be nested transforms.
	=== Clean up XML Elements ===		=== Clean up XML Elements ===
	* '''''Collapse multiple redundant groups'''''		* '''''Collapse multiple redundant groups'''''
Line 35:		Line 35:

	* '''''Remove Default values, i.e. opacity: 1;'''''		* '''''Remove Default values, i.e. opacity: 1;'''''
	''DONE''.		''DONE v0.8''.
	* '''''Remove Not applicable values, i.e. opacity: 0; fill-color: #00000;'''''		* '''''Remove Not applicable values, i.e. opacity: 0; fill-color: #00000;'''''
	Not sure what is meant here.		Not sure what is meant here.
Line 41:		Line 41:
	''Not done, easy, med priority''.		''Not done, easy, med priority''.

	''DONE''. I convert everything to rgb(...) because I like it for programmability and the CSS DOM seems to like them.		''DONE v0.8''. I convert everything to rgb(...) because I like it for programmability and the CSS DOM seems to like them.
	* '''''Convert RGB colours from #RRGGBB to #RGB if possible'''''		* '''''Convert RGB colours from #RRGGBB to #RGB if possible'''''
	''Not done, easy, med priority''.		''Not done, easy, med priority''.

	=== Clean up paths ===		=== Clean up paths ===
	''DONE'' (my way) What isn't mentioned here, and is fully implemented in islint, is recovering, circles, ellipses, lines, polylines and polygons. islint parses 'd' attributes into path segments, analyzes them, converts if possible, else puts them back together being very stingy with white space. A large effort was put forth here, so the code is in good shape for further reduction operations on paths. The sodipodi namespace data makes it possible to recover circles and arcs.		''DONE v0.8'' (my way) What isn't mentioned here, and is fully implemented in islint, is recovering, circles, ellipses, lines, polylines and polygons. islint parses 'd' attributes into path segments, analyzes them, converts if possible, else puts them back together being very stingy with white space. A large effort was put forth here, so the code is in good shape for further reduction operations on paths. The sodipodi namespace data makes it possible to recover circles and arcs.
	* '''''Detect vertical/horizontal lines and replace.'''''		* '''''Detect vertical/horizontal lines and replace.'''''
	''Not done, easy, high priority''.		''Not done, easy, high priority''.
Line 67:		Line 67:

	=== Output Standard SVG ===		=== Output Standard SVG ===
	''DONE''. islint removes all namespaces it has not been told to keep. It is possible to tell it to preserve foreign namespaces by adding them through an option.		''DONE v0.8''. islint removes all namespaces it has not been told to keep. It is possible to tell it to preserve foreign namespaces by adding them through an option.
	* '''''Remove inkscape namespace'''''		* '''''Remove inkscape namespace'''''
	* '''''Remove sodipodi namespace'''''		* '''''Remove sodipodi namespace'''''