Uploaded image for project: 'XWiki Platform'
  1. XWiki Platform
  2. XWIKI-9176

New XWiki Syntax Guide



    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 3.0
    • Fix Version/s: 5.3-milestone-2
    • Component/s: Help
    • Labels:
    • Difficulty:
    • Pull Request Status:
      Awaiting Committer feedback
    • Similar issues:


      In the last few weeks I built a new Syntax Guide following the third suggestion of Ecaterina Valica (see: http://incubator.myxwiki.org/xwiki/bin/view/Improvements/SyntaxExperiments3 ). This one is based on the new 3.0 Admin app that has been created by... Sergiu, IIRC.

      You will find the Guide I built in the attached .xar file. I would just like to point a couple of things about the code.

      • Every section displayed in the guide is placed on a single document that should ideally be named something like XWikiSyntaxNewSection
      • Every section page should have the following outline:
        1. Level 1 heading: Holds the name of the category in which the section is displayed (will be retrieved from first section to be added to a category)
        2. Level 2 heading: Holds the name of the section
        3. Level 5 headings: One heading/section for each version of the syntax information to be displayed. Heading must be the appropriate version number (e.g. "===== 2.0 =====")
      • The XWikiSyntaxClass holds the following information and has to be attached to every section page:
        • category: The 0-based number of the category in which the section should be displayed.
        • section: The 0-based number at which the section should be displayed within the category.
        • minSyntaxVersion: The first syntax version for which syntax information is available (if the selected version is smaller than this value the section will be hidden)
        • maxSyntaxVersion: The last syntax version for which syntax information is available (if the selected version is greater than this value the last available version will be displayed)
      • In order to display the version numbering according to the current selection despite actually displaying section of previous version (see maxSyntaxVersion) the version number should be replaced as follows:
      2.0 -> {{velocity}}$crtSyntaxVer{{/velocity}}

      While content and section/category names can be translated by just translating the syntax pages the following three ApplicationRessources will have to be added:

      xe.syntax.syntaxpage.title=XWiki Syntax Guide
      xe.syntax.syntaxtitle=XWiki Syntax {0}

      See the attached xar package for the sources to the entire guide. Content-wise it is roughly what has been in the latest revision of the "old" Syntax Guide.


          Issue Links



              camil7 Clemens Robbenhaar
              jstoldt Johannes Stoldt
              2 Vote for this issue
              6 Start watching this issue


                Date of First Response: