Changeset 929 for trunk/EditSyntaxPlugin/data/TWiki/EditSyntaxPlugin.txt
- Timestamp:
- 11/25/08 00:57:30 (4 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/EditSyntaxPlugin/data/TWiki/EditSyntaxPlugin.txt
r899 r929 2 2 ---+!! Edit Syntax Plugin (Alpha version - unsafe for public websites) 3 3 4 This Plugin allows users to edit TWiki content with their favorite wiki syntax. Users can set their preferred syntax as a user preferences setting in their user homepage. Edit syntax converters convert the TWiki markup language (TML) into another syntax when a user edits a topic, and converts it back after edit. The content is always saved in the TWiki format, that is, users can edit the same content using different edit syntax.4 This Plugin allows users to edit Foswiki content with their favorite wiki syntax. Users can set their preferred syntax as a user preferences setting in their user homepage. Edit syntax converters convert the Topic markup language (TML) into another syntax when a user edits a topic, and converts it back after edit. The content is always saved in the Foswiki format, that is, users can edit the same content using different edit syntax. 5 5 6 6 %TOC% … … 13 13 Currently available converters: 14 14 | *Syntax* | *To Activate* | *Syntax Summary and Help* | *Converter topic* | 15 | = TWiki= | =<nop> * Set EDITSYNTAX = <nop>= | [[%SYSTEMWEB%.WikiSyntaxSummary][Summary]], [[%SYSTEMWEB%.TextFormattingRules][Help]] | N/A |15 | =Foswiki= | =<nop> * Set EDITSYNTAX = <nop>= | [[%SYSTEMWEB%.WikiSyntaxSummary][Summary]], [[%SYSTEMWEB%.TextFormattingRules][Help]] | N/A | 16 16 %SEARCH{ "EditSyntaxRegex" scope="topic" topic="*EditSyntaxRegex" nonoise="on" format="| =$percntCALC{$SET(name, $SUBSTITUTE($topic, EditSyntaxRegex))$GET(name)}$percnt= | =<nop> * Set EDITSYNTAX = <nop>$percntCALC{$GET(name)}$percnt= | [[$percntCALC{$GET(name)}$percntWikiSyntaxSummary][Summary]], [[$percntCALC{$GET(name)}$percntTextFormattingRules][Help]] | [[$topic][$percntCALC{$GET(name)}$percnt converter]] |" }% 17 17 … … 23 23 </pre> 24 24 25 To disable the converter (e.g. to use TWiki syntax), set the EDITSYNTAX to an empty value.25 To disable the converter (e.g. to use Foswiki syntax), set the EDITSYNTAX to an empty value. 26 26 27 27 … … 31 31 1. Decide on the base name, =Foowiki=. Base name must not be a !WikiWord, e.g. not =FooWiki=. 32 32 1. Create a =FoowikiEditSyntaxRegex= topic in the %SYSTEMWEB% web, taking MediawikiEditSyntaxRegex as a template. 33 * List regular expressions to convert the syntax from the TWiki to the Foowiki format, and vice versa.33 * List regular expressions to convert the syntax from the Foswiki to the Foowiki format, and vice versa. 34 34 * The converter format is indicated below. 35 35 * All topics ending in =*EditSyntaxRegex= are listed automatically in the converter topic. … … 43 43 44 44 The converter topic contains bullets of format: =* TYPE: /from/to/= or =* TYPE: /from/to/ # comment= 45 * =TYPE= is =T2X= for "T Wiki to External" syntax conversion, or =X2T= for "External to TWiki" syntax conversion.45 * =TYPE= is =T2X= for "TML (Foswiki topic markup language) to External" syntax conversion, or =X2T= for "External to TML" syntax conversion. 46 46 * =/from/to/= are regular expressions to convert from one format to the other. 47 47 * =# comments= to annotate the expressions are optional. The hash sign requires a space to be recognized as a space. … … 59 59 60 60 * One line description, is shown in the %SYSTEMWEB%.TextFormattingRules topic: 61 * Set SHORTDESCRIPTION = Edit TWiki content using your preferred wiki syntax61 * Set SHORTDESCRIPTION = Edit Foswiki content using your preferred wiki syntax 62 62 63 63 * Debug plugin: (See output in =data/debug.txt=) … … 67 67 ---++ Plugin Installation Instructions 68 68 69 __Note:__ You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.69 __Note:__ You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the Foswiki server. 70 70 71 71 * Download the ZIP file from the Plugin web (see below) … … 73 73 | *File:* | *Description:* | 74 74 | ==data/System/%TOPIC%.txt== | Plugin topic | 75 | ==data/ TWiki/MediawikiEditSyntaxRegex.txt== | Mediawiki edit syntax converter topic |76 | ==data/ TWiki/MediawikiWikiSyntaxSummary.txt== | Mediawiki edit syntax summary topic |77 | ==data/ TWiki/MediawikiTextFormattingRules.txt== | Mediawiki edit syntax help topic |78 | ==data/ TWiki/MediawikiEditSyntaxTest.txt== | Mediawiki edit syntax test topic |75 | ==data/System/MediawikiEditSyntaxRegex.txt== | Mediawiki edit syntax converter topic | 76 | ==data/System/MediawikiWikiSyntaxSummary.txt== | Mediawiki edit syntax summary topic | 77 | ==data/System/MediawikiTextFormattingRules.txt== | Mediawiki edit syntax help topic | 78 | ==data/System/MediawikiEditSyntaxTest.txt== | Mediawiki edit syntax test topic | 79 79 | ==lib/Foswiki/Plugins/%TOPIC%.pm== | Plugin Perl module | 80 80 * Configure the Plugin: 81 * TWiki 4.0 and up:Run the [[%SCRIPTURL%/configure%SCRIPTSUFFIX%][configure]] script to enable the Plugin81 * Run the [[%SCRIPTURL%/configure%SCRIPTSUFFIX%][configure]] script to enable the Plugin 82 82 * Change the Plugin settings as needed 83 * Patch TWiki if you are running TWiki 4.0.0 - 4.0.5:84 * Apply TWiki:Codev/AfterEditHandlerCallFix to fix a bug in the Plugin API.85 83 * Test if the installation was successful: 86 84 * Enable the Mediawiki syntax with this setting in your home page: … … 89 87 * You should see the content in Mediawiki syntax 90 88 * Save the test topic 91 * View raw should show you the content in TWiki syntax89 * View raw should show you the content in Foswiki syntax 92 90 * Show proper edit syntax summary in edit screen: 93 91 * Create an =EDITSYNTAX= setting in your =%USERSWEB%.SitePreferences= and set it to an empty value
Note: See TracChangeset
for help on using the changeset viewer.
