Snippets

A snippet is a small container of re-usable code (math, text, regions). Ordinarily, it is intended as an unit to incorporate into larger programming modules.

Snippets in SMath Studio are simple *.sm files that are placed into the special "snippets" folder.

((('''Index'''
* [#Use|How to use a snippet]
* [#Make|How to make a snippet]
* [#History|History]
* [#SeeAlso|See also]
* [#References|References])))


{BR}[anchor|#Use]
==How to use a snippet==
Every snippet can be inserted into the page:

* using the '''Dynamic Assistance''';

{{{{
* pressing TAB will insert snippet inside the collapsed Area Region
* pressing Shift+TAB will insert just all snippet expressions without Area Region}}}}

{{{{[image|Dynamic assistance|{UP}Snippets%2fsnippets_use_01.gif]}}}}

* directly from the '''Snippet Manager''' of the '''Tools''' menu group.

{{{{[image|Snippet Manager|{UP}Snippets%2fsnippets_use_02.gif]}}}}

In the '''Snippet Manager''' it is possible to download snippets made by other users and shared through the [http://en.smath.info/forum/default.aspx?g=posts&m=12486|Relase Manager]; to do this, change the top-right button target from '''Local storage''' to '''Online gallery'''.

{{{{[image|More snippets|{UP}Snippets%2fsnippets_use_03.png]}}}}

{{{{The snippets downloaded through the Extensions Manager are stored in the user's folder ''%APPDATA%\SMath\extensions\snippets''}}}}


{BR}[anchor|#Make]
==How to make a snippet==
To make a *.sm file a snippet, follow these steps:

* go in the '''File''' > '''Properties''' > '''File attributes''' menu and setup a '''Snippet Shortcut''';

{{{{[image|Snippet Manager|{UP}Snippets%2fsnippets_make_01.png]}}}}

* save the file in the '''snippets''' folder (in Windows 7 this is usually ''C:\Program Files (x86)\SMath Studio\snippets'');


{BR}[anchor|#History]
==History==

* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=5857|0.90] (Stable): Snippets feature implemented;
* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=7371|0.95.4594] (Stable): all the available snippet's title translations are included to collapsed Area on snippet insert;
* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=13245|0.97.5280] (Nightly build): Fixed inserted snippet layout when collapsed Area Region exists inside Snippet;


{BR}[anchor|#SeeAlso]
==See also==

* Extensions manger: [http://en.smath.info/forum/default.aspx?g=posts&m=12486|Forum]


{BR}[anchor|#References]
==References==

* Snippets feature: [http://en.smath.info/forum/default.aspx?g=posts&m=3563|Forum]