Ignore:
Timestamp:
11/25/08 00:57:30 (4 years ago)
Author:
KennethLavrsen
Message:

Item221: Finish the TWiki:Codev to Foswiki:xxx conv
Had to leave a few behind in docs that were to hard to convert
old extensions that probably are out of date

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/EditSyntaxPlugin/data/TWiki/EditSyntaxPlugin.txt

    r899 r929  
    22---+!! Edit Syntax Plugin (Alpha version - unsafe for public websites) 
    33 
    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. 
     4This 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. 
    55 
    66%TOC% 
     
    1313Currently available converters: 
    1414| *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 | 
    1616%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]] |" }% 
    1717 
     
    2323</pre> 
    2424 
    25 To disable the converter (e.g. to use TWiki syntax), set the EDITSYNTAX to an empty value. 
     25To disable the converter (e.g. to use Foswiki syntax), set the EDITSYNTAX to an empty value. 
    2626 
    2727 
     
    3131   1. Decide on the base name, =Foowiki=. Base name must not be a !WikiWord, e.g. not =FooWiki=. 
    3232   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. 
    3434      * The converter format is indicated below. 
    3535      * All topics ending in =*EditSyntaxRegex= are listed automatically in the converter topic. 
     
    4343 
    4444The converter topic contains bullets of format: =* TYPE: /from/to/= or =* TYPE: /from/to/ # comment= 
    45    * =TYPE= is =T2X= for "TWiki 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. 
    4646   * =/from/to/= are regular expressions to convert from one format to the other. 
    4747   * =# comments= to annotate the expressions are optional. The hash sign requires a space to be recognized as a space. 
     
    5959 
    6060   * One line description, is shown in the %SYSTEMWEB%.TextFormattingRules topic: 
    61       * Set SHORTDESCRIPTION = Edit TWiki content using your preferred wiki syntax 
     61      * Set SHORTDESCRIPTION = Edit Foswiki content using your preferred wiki syntax 
    6262 
    6363   * Debug plugin: (See output in =data/debug.txt=) 
     
    6767---++ Plugin Installation Instructions 
    6868 
    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.  
    7070 
    7171   * Download the ZIP file from the Plugin web (see below) 
     
    7373     | *File:* | *Description:* | 
    7474     | ==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 | 
    7979     | ==lib/Foswiki/Plugins/%TOPIC%.pm== | Plugin Perl module | 
    8080   * Configure the Plugin: 
    81       * TWiki 4.0 and up: Run the [[%SCRIPTURL%/configure%SCRIPTSUFFIX%][configure]] script to enable the Plugin 
     81      * Run the [[%SCRIPTURL%/configure%SCRIPTSUFFIX%][configure]] script to enable the Plugin 
    8282      * 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. 
    8583   * Test if the installation was successful: 
    8684      * Enable the Mediawiki syntax with this setting in your home page: 
     
    8987         * You should see the content in Mediawiki syntax 
    9088         * Save the test topic 
    91          * View raw should show you the content in TWiki syntax 
     89         * View raw should show you the content in Foswiki syntax 
    9290   * Show proper edit syntax summary in edit screen: 
    9391      * 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.