#README

This readme contains example calls to the .xslts created for debugging and improving the SyntaxDefinition.xmls contained in a SubEthaEdit/Coda2-Mode.

Overview:

1. All XML-Nodes using a scope
2. All Scopes used in a Mode
3. Simple Style Sheet for one style attribute
4. Simple Style Sheet for all style attributes
5. Remove style attributes from Mode
6. Rename Scope
7. Sort Plist
8. Update Plist
9. List Plist Values
10. Style Extraction Makefile
11. XSLT/XML help

XMLTagsForScope.xslt

Printing all XML-Nodes that are a certain scope (eg. keyword.function) for a single Mode (opened in SubEthaEdit in XML-Mode):

xsltproc --param scope "'<scope>'" --novalid XMLTagsForScope.xslt <path>/<mode-name>.mode/Contents/Resources/SyntaxDefinition.xml | see --mode xml

Printing all XML-Nodes for multiple Modes:

find <path> -name "SyntaxDefinition.xml" -exec xsltproc --param scope "'<scope>'" --novalid XMLTagsForScope.xslt \{\} \; | see --mode xml

Adding a root node to the the resulting XML:

( echo "<modes>"; find <path>  -name "SyntaxDefinition.xml" -exec xsltproc --param scope "'<scope>'" --novalid XMLTagsForScope.xslt \{\} \;; echo "</modes>" ) | see --mode xml

ScopesInMode.xslt

Returning all scopes used in a single Mode (eg. PHP-HTML):

xsltproc --novalid ScopesInMode.xslt <path>/<mode-name>.mode/Contents/Resources/SyntaxDefinition.xml | see

Returning all scopes used by multiple Modes:

find <path> -name "SyntaxDefinition.xml" -exec xsltproc --novalid ScopesInMode.xslt \{\} \; | see

Returning all scopes used by multiple Modes - sorted and uniqued:

find  <path> -name "SyntaxDefinition.xml" -exec xsltproc --novalid ScopesInMode.xslt \{\} \; | awk '{print $1}' | sort | uniq | see

StyleSheetForAttribute.xslt

Returning a style sheet for a scope style (eg. color) used by a single Mode (eg. PHP-HTML) (opened in SubEthaEdit in CSS-Mode):

xsltproc --param style-attribute "'<style-attribute>'" --novalid StyleSheetForAttribute.xslt <path>/<mode-name>.mode/Contents/Resources/SyntaxDefinition.xml | see --mode css

Returning a style sheet for a scope style used by multiple Modes - sorted:

find  <path> -name "SyntaxDefinition.xml" -exec xsltproc --param style-attribute "'<style-attribute>'" --novalid StyleSheetForAttribute.xslt \{\} \; | sort | uniq | see --mode css

StyleSheetForAllAttributes.xslt

Returning a style sheet for all scope styles (color, inverted-color, background-color, inverted-background-color, font-trait, font-weight, font-style) used by a single Mode (eg. PHP-HTML) (opened in SubEthaEdit in CSS-Mode):

xsltproc --novalid StyleSheetForAllAttributes.xslt <path>/<mode-name>.mode/Contents/Resources/SyntaxDefinition.xml | see --mode css

Returning a style sheet for all scope styles used by multiple Modes - sorted:

find  <path> -name "SyntaxDefinition.xml" -exec xsltproc --novalid StyleSheetForAllAttributes.xslt \{\} \; | sort | see --mode css

RemoveStyleAttributes.xslt

Removing all style attributes (color, inverted-color, background-color, inverted-background-color, font-trait, font-weight, font-style from a Mode (eg. PHP-HTML) (opened in SubEthaEdit in XML-Mode):

xsltproc --novalid RemoveStyleAttributes.xslt <path>/<mode-name>.mode/Contents/Resources/SyntaxDefinition.xml | see --mode xml

RenameScope.xslt

Renaming a scope (eg. meta.default) in a single Mode (eg. PHP-HTML) (opened in SubEthaEdit in XML-Mode):

xsltproc --param from "'<scope-value>'" --param to "'<new-scope-value>'" --novalid RenameScope.xslt <path>/<mode-name>.mode/Contents/Resources/SyntaxDefinition.xml | see --mode xml

SortInfoPlist.xslt

Bringing the known plist keys into the following order:
CFBundleIdentifier
CFBundleName
NSHumanReadableCopyright
CFBundleGetInfoString
CFBundleShortVersionString
CFBundleVersion
SEEMinimumEngineVersion
CFBundlePackageType
CFBundleInfoDictionaryVersion

The TCMModeExtensions key-array pair will be deleted by this and should be moved to the ModeSettings.xml.

xsltproc --novalid SortInfoPlist.xslt <path>/<mode-name>.mode/Contents/Info.plist | see --mode xml

RenameScope.xslt

Changing a plist key (eg. CFBundleShortVersionString) value to something else in a single Mode (eg. PHP-HTML) (opened in SubEthaEdit in XML-Mode):

xsltproc --param key "'<key>'" --param to "'<to>'" --novalid UpdateInfoPlist.xslt <path>/<mode-name>.mode/Contents/Info.plist | see --mode xml

PlistValueForKey.xslt

Getting textfile with the value for a plist key (eg. CFBundleShortVersionString) in a single Mode (eg. PHP-HTML):

	xsltproc --param key "'<key>'" --novalid PlistValueForKey.xslt <path>/<mode-name>.mode/Contents/Info.plist | see

Makefile

make and make help: prints a short how-to

make create-style-sheet : generates style sheets from the style info in the definition files
make create-style-sheet mode_directory=<path/to/Modes/Folder/> : generates style sheets for the modes in folder
make create-style-sheet style_directory=<path/to/Style/Folder/> : generates style sheets in folder

make remove-styles : generates SyntaxDefinition.xmls without style information
make remove-styles mode_directory=<path/to/Modes/Folder/> : generates new xml for the modes in folder
make remove-styles result_mode_directory=<path/to/Result/Mode/Folder/> : generates new xml in folder

make style-extraction : calls both create-style-sheet and remove-styles for one step extraction

make rename from=<scope> to=<scope> : generates new xml in results folder with renamed scopes

make update-plist key=<key> to=<value> : generates new plist in results folder with changed value
make sort-plist generates sorted plist in results folder - removing unknown keys

make plist-values key=<key> : generates a list of the values used for the given key
make all-plist-values : generates a list of the values used for all the keys

make find-scope scope=<scope> : generates a xml files containing all the uses of
make all-scopes-one-mode mode=<mode> : generates an annotated txt with scopes used by a mode
make all-scopes-by-lang : generates an annotated txt with scopes used by all modes
make all-scopes-uniqued : generates a txt with sorted scopes used by all modes

make clean : deletes all the generated .sss files and result .mode directories

For more information about this Makefile drop it onto the text editor of your choice and have fun.

##PS: Examples Modes - SEE - relative path in repository: ../../Modes
Modes - Coda2 - relative path in repository: Coda2Modes/

• Examples for XMLTagsForScope.xslt

    xsltproc --param scope "'language.operator'" --novalid XMLTagsForScope.xslt ../../Modes/PHP-HTML.mode/Contents/Resources/SyntaxDefinition.xml | see --mode xml
  
    find ../../Modes/ -name "SyntaxDefinition.xml" -exec xsltproc --param scope "'language.operator'" --novalid XMLTagsForScope.xslt \{\} \; | see --mode xml
  
    ( echo "<modes>"; find ../../Modes/ -name "SyntaxDefinition.xml" -exec xsltproc --param scope "'language.operator'" --novalid XMLTagsForScope.xslt \{\} \;; echo "</modes>" ) | see --mode xml
  

• Examples for ScopesInMode.xslt

    xsltproc --novalid ScopesInMode.xslt ../../Modes/PHP-HTML.mode/Contents/Resources/SyntaxDefinition.xml | see
  
    find ../../Modes/ -name "SyntaxDefinition.xml" -exec xsltproc --novalid ScopesInMode.xslt \{\} \; | see
  
    find ../../Modes/ -name "SyntaxDefinition.xml" -exec xsltproc --novalid ScopesInMode.xslt \{\} \; | awk '{print $1}' | sort | uniq | see
  

• Examples for StyleSheetForAttribute.xslt

    xsltproc --param style-attribute "'background-color'" --novalid StyleSheetForAttribute.xslt ../../Modes/ASP-HTML.mode/Contents/Resources/SyntaxDefinition.xml | see --mode css
  
    find ../../Modes/ -name "SyntaxDefinition.xml" -exec xsltproc --param style-attribute "'background-color'" --novalid StyleSheetForAttribute.xslt \{\} \; | sort | uniq | see --mode css
  

• Examples for StyleSheetForAllAttributes.xslt

    xsltproc --novalid StyleSheetForAllAttributes.xslt ../../Modes/ASP-HTML.mode/Contents/Resources/SyntaxDefinition.xml | see --mode css
  
    find ../../Modes -name "SyntaxDefinition.xml" -exec xsltproc --novalid StyleSheetForAllAttributes.xslt \{\} \; | sort | see --mode css
  

• Examples for RemoveStyleAttributes.xslt

    xsltproc --novalid RemoveStyleAttributes.xslt ../../Modes/ASP-HTML.mode/Contents/Resources/SyntaxDefinition.xml | see --mode xml
  

• Examples for RenameScope.xslt

    xsltproc --param from "'meta.default'" --param to "'magic.bullet'" --novalid RenameScope.xslt ../../Modes/PHP-HTML.mode/Contents/Resources/SyntaxDefinition.xml | see --mode xml
  

• Examples for UpdateInfoPlist.xslt

    xsltproc --param key "'CFBundleShortVersionString'" --param to "'4.0'" --novalid UpdateInfoPlist.xslt ../../Modes/XML.mode/Contents/Info.plist | see --mode xml
  

• Examples for PlistValueForKey.xslt

    xsltproc --param key "'CFBundleShortVersionString'" --novalid PlistValueForKey.xslt ../../Modes/XML.mode/Contents/Info.plist | see --mode xml
  

• Examples for SortInfoPlist.xslt

    xsltproc --novalid SortInfoPlist.xslt ../../Modes/XML.mode/Contents/Info.plist | see --mode xml
  

• Random other helper calls:

    find  ../../Modes/ -name "InfoPlist.strings" -exec cat \{\} \; | see
    find  ../../Modes/ -name "InfoPlist.strings" -exec see \{\} \;
  

• Testing xpath expressions

    xmllint --xpath "//keywords[@id='Operators']" Coda2Modes/PHP-HTML.mode/Contents/Resources/SyntaxDefinition.xml 
  

• Since xmllint doesn't know about namespaces per default (you can set it using the setns command if you use --shell though) you can use the local-name() function to match against the element name without namespace

    xmllint --xpath "//*[local-name()='element']" SortInfoPlist.xslt