Editing user appearance, written or text templates stylesheets

Editing a user Appearance stylesheet

1. To edit a user Appearance stylesheet, select the stylesheet and then Edit/View. Stitchmastery stylesheets can not be edited.

2. The Appearance Stylesheet dialog opens ready for editing.

   Name and namespace cannot be edited as this would invalidate the alias.

   Description can be edited.

    

    

   The following explains the different values and how they are used by Stitchmastery;-

   • Default Font - used for all text on the chart and key except for the chart and key titles. This font is assigned either when a chart diagram is created or when an element is added to the chart, for example when a row or column is added to a chart or an edit causes a new entry to be added to the key. The font can be overridden by using the Edit Font command.

   • Default Font (Key and Chart titles) - used as above but for the chart and key titles only.

   • Stitch symbol colour automatically contrasts with background colour - if this is not set then the symbol colour remains black even if the background colour is dark. If set, then when the background colour is dark, the symbol colours switches automatically to white. Note that this does not apply to stitches that have custom foreground and background colours set.

   • Grid (click either on the right pointing triangle or on More on grid ... to expand the Grid display):

     Grid Cell Width and Height - the size of each chart cell in pixels. This size is also used for the key entry boxes.

     Grid Colour - used for the grid on all charts and for the outline of boxes in the key.

   • Grid highlighting (click either on the right pointing triangle or on More on grid highlighting... to expand the Grid highlighting display):

     Highlight Grid Lines - used to turn grid highlighting on and off.

     Number of Columns / Rows between Highlighted Grid Lines - use to control the frequency of the highlighting lines if highlighting is turned on.

     Highlight Colour - used as the colour of the highlighting if grid highlighting is set.

   • Annotating repeated stitches (click either on the right pointing triangle or on More on annotations... to expand the Annotating repeated stitches display):

     In order to show annotations and be able to edit the annotations values, select Display Annotations.

     The Minimum number of stitches defines the number of similar stitches that must be next to each other before an annotation is displayed. Any 'stretch' less than this number is not annotated. This number must be between 3 and 9.

     Select Number background transparent to have the number drawn with a transparent background. If not selected, the number is drawn with a white background. A transparent background is useful for a colourwork chart, whilst a white background is best if the number is in front of symbols and grid lines.

     If Automatically contrasts with yarn/colour is selected then, if the background colour is dark the number colour swaps to white. Note that this only works if Include colour in written instructions is also selected.

     The font for the numbers can be selected.

     There are four options for the horizontal positioning of the annotation number within the stretch of repeated stitches; Left, Right and Centre position in the number to the left, right or centre of the stretch respectively. Beginning places the number at the beginning of the stretch. That is, for right side rows and for charts worked in the round, the number is always on the right hand side, whilst it is on the left for wrong side rows.

     The vertical position can be set to either Top, Bottom or Middle

     Once the number's horizontal and vertical positions have been set, its exact location can be fine tuned by editing the Gap at sides and Gap at top/bottom values. However, these values have no effect if the number is centred.

   • Borders (click either on the right pointing triangle or on More on borders... to expand the Borders display):

     All the values here are used when creating a Border for the first time. To edit the values for any Border, once created, see Editing a Border .

     Border display text is the default text that is the key entry when a border is first created.

     Border position, Border colour, Line style and Width of border should all be self-explanatory.

     Move border inwards allows for a border to be shifted inwards (positive values) or outwards (negative values) from the centre line of the grid. This can be useful where adjoining or overlapping borders would otherwise mask each other. By shifting on or more of the borders, both of them can be made visible. The sides of each border can be moved individually.

     All of these values can be edited for individual borders once they are created. See Editing a Border.

   Select OK to finish editing the stylesheet.

Editing a user Written stylesheet 

1. To edit a user Written stylesheet, select the stylesheet and then Edit/View. Stitchmastery stylesheets cannot be edited.

2. The Written Stylesheet dialog opens ready for editing.

   Name and namespace cannot be edited as this would invalidate the alias.

   Description can be edited.

   

   The following explains the different values and how they are used by Stitchmastery;-

   • Capitalise row/round contents - if set, always capitalises the written instructions for example 'Row 1: K1, p1, k2' instead of 'Row 1: k1, p1, k2'.

   • Ignore hidden rows - if set and rows are hidden in a chart, then the rows are excluded from the Output Text View as well as being ignored when a chart is being validated.

   • Condense rows/rounds when possible - if set, Stitchmastery looks for patterns of rows/rounds that are repeated. If not, then each row/round is written out in detail regardless of whether it is similar to a previous row/round.

   • Include stitch count - choose from three different options for whether a stitch count should be displayed. Note that this is the total stitch count for a row/round.

   • Include RS/WS labels for rows - choose from four different options for whether RS/WS labels should be displayed. This option does not apply for charts set to 'round'.

    Select OK to finish editing the stylesheet.

Editing a user Text Templates stylesheet 

1. To edit a user Text Templates stylesheet, select the stylesheet and then Edit/View. Stitchmastery stylesheets cannot be edited.

2. The Text Templates Stylesheet dialog opens ready for editing.

   Name and namespace cannot be edited as this would invalidate the alias.

   Description and Language can both be edited.

   

    

   Text templates allow users to control the content of all text that is automatically generated by the software. Templates combine text with variables and (rarely) template control words. Variables are identified by the dollar sign and enclosing parentheses and are replaced with the appropriate text value when the text is generated. In some cases a variable represents the output from a different template. Each template has a 'context' for when it is used and the variables that are appropriate for the template are determined by its context.

   Template control words are identified by a percentage sign and have a specific meaning that controls the text generated. See Template Control Words for more information on using control words.

   The following describes how to edit a template. For more information on each template, when it is used and the variables that can be entered for each template see Text Templates.

   1. In the Text Templates Stylesheet dialog, templates are grouped together under different tabs. Change tabs until you find the relevant template. Select the template to be edited.

   2. A preview of the selected template is displayed in the Preview box.

      

      Select Edit. The Edit Key Entry Template dialog appears;-

       

       

   3. Within the Pattern text box you can type any text. Text will appear unchanged in the key entry text. This includes 'white space' such as spaces and tabs at the beginning and end of the template as well as new lines within the template.

   4. Select Insert Variable to insert a variable into the text.

   5. A list of variables is displayed. Select a variable to display a panel that shows the variable definition.

      Double click a variable in the list to cause it to be added to the template.

   6. Below is an example where both the abbreviation and displayString variables are used, separated by a hyphen;-

      

   7. Select OK in all dialogs to finish editing the stylesheet and to save changes.

   8. Once the template is saved, all key entries for circular charts that use this Text Templates stylesheet will use it to generate the key entry text as shown below;-

      

      Note that, for key entries, the key entry text is only generated when a stitch is added to the key as a result of editing or if the key entry text is specifically refreshed. See Editing Chart Properties for details of how to refresh key entries.

   Alternative sources of explanation: