How to install and use SweeTS

Installation

• Linux users need to download and install Wine first
• Download PSPad
• Install/ unzip PSPad at "c:\program files\pspad"
• Download SweeTS and unzip it to your desktop
• Copy the directory "pspad" of the "sweets.zip" over "c:\program files\pspad"
• start PSPad
• Go to "Settings > Highlighter Settings" and click at the dialogue on the tab "Specification"
• On the left highlighter list scroll down and select "<not assigned>"
• At the list "User Highlighters" scroll down and select "TypoScript"
• Use the browse button "..." to add the SweeTS TypoScript help file, it is located in "c:\program files\pspad\help"; at the bottom you can add the "{ }" brackets for automatic indention
• Now press "OK" and confirm the Highlighter settings
• To use the TYPO3 skin fo PSPad go to "Settings > Program Settings..." and click "Program look"
• At dropdown "Toolbar button icon set" just select "TYPO3"; confirm settings by pressing "OK"
• Here is a screenshots with correct settings
• Close PSPad and start it again – now you have a full featured TypoScript development enviroment :)

Using SweeTS TypoScript Editor

• To avoid the Copy&Paste method between PSPad and TYPO3 backend you can use external TypoScript files and edit them with PSPad via FTP. Add the following to your Setup field (after developing don't forget to set no_cache to 0):
  [globalVar = TSFE : beUserLogin> 0]
  config.no_cache = 1
  [global]
  <INCLUDE_TYPOSCRIPT: source="FILE: fileadmin/#YourPath/#YourFile.ts">
  Add this into your user TSconfig field in TYPO3 backend at Tools > Useradmin:
  admPanel.override.tsdebug.forceTemplateParsing = 1
  So while you are logged in at TYPO3 backend (may over the browser sidebar) you don't have
  to clear the cache
• To get *.ts files edited at backend of TYPO3 you must allow editing of files by add this line to your typo3conf/localconf.php
  $TYPO3_CONF_VARS['SYS']['textfile_ext'] = 'txt,html,htm,css,inc,php,php3,tmpl,js,sql,ts';
• Protect your TypoScript and template files from being viewed with a webnbrowser by setting up a .htaccess file too:
  <FilesMatch "\.(ts|tmpl)$">
  deny from all
  </FilesMatch>
• The FTP/ file browser panel of PSPad on the left side will allow you to edit external TypoScript files
• You can setup the colors of the highlighter at Settings > Highlighter Setting at the tab "Colors"
• Use the toolbar icon "Create new file" or shortcut "Ctrl+N" to start with a TypoScript template
• Use autocomplete with shortcut "Ctrl+J"
• Use macro dialogues with "Ctrl+Space"
• Yelect a word and press "Alt+F1", that will open the TypoScript help file and search the index of it for the selected command
• Using the toolbar icon "Code explorer window" or pressing shortcut "Shift+Ctrl+E" will enable/ disable the code explorer panel
• If you need additional help for development you can check out the sites and communities listed under "Help > Online Help > TypoScript"; every entry will open a website in your default web browser
• Personal snippets, links, tools can be added to the favorite panel of the left side (if they didn't get lost on updates)
• If you didn't like to use FTP an alternative way could be the Firefox extension It's all Text!
• If you are in trouble with the integrated Windows help file, check out the hint "CHM help files on networks"

Limitations & Workarounds

• Code between "( )" brackets will be highlighted as comments (mostly used for HTML values)
• The TypoScript Code formating does not work with round brackets "( )"
• Comments using "#" must be formated like this "#| ... |#" to differ from markers (###marker###), but line comments "//" and block comments "/* */" are fully supported
• At the moment the code explorer only shows entries for code blocks formated with "{ }" brackets in alphabetic order
• PSPad offers no support for SFTP or SCP (you may try out ExpanDrive)