(anonymous guest) (logged out)

Copyright (C) by the contributors. Some rights reserved, license BY-SA.

Sponsored by the Wiki Symposium and the Nuveon GmbH.

 
This is version . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

There are two possible approaches to definining syntax of links with descriptions -- they differ in the order in which the address and the link description appear in the raw text of the page. Both approaches have their advantages and disadvantages -- in the end the preferences depend heavily on personal habits and style -- thus there is a number of wiki engines with one or the other approach. This is veru unfortunate for Creole, because no matter which option we choose, we make implementing the MixedMode in some engines impossible.

Initially, we have chosen to follow the voice of the majority, and choose the way of the UseMod wiki, with the address first and description last. The reason is simple -- many wikis based their markup on the UseMod's rules. There is, however, a number of text markup standards that use opposite order -- most notably CrossMark.

There is however a third way -- introducing own link markup format, that wouldn't conflict with markups of existing wikis.

Change Proposal #

[[ description -> link ]]

Advantages #

  • used by PmWiki, so it is NotNew
  • works better with international keyboards
  • the order of link and description is indicated in the markup

Disadvantages #

  • new for most users
  • the '[', ']' and '>' characters are not available on some keyboards, eg. the russian keyboard layout
  • slower to type
  • really confusing on right-to-left languages like Hebrew

Current Syntax in Creole #

[[link|description]]

Advantages #

  • currently most used wiki syntax for internal links
  • similar to the most popular syntax for external links (minus the pipe)
  • faster to type

Disadvantages #

  • the order of link and description is not marked
  • the '[', ']' and '|' characters are not available on some keyboards, eg. the russian keyboard layout

Add new attachment

Only authorized users are allowed to upload new attachments.

« This particular version was published on 16-Jan-2007 15:31 by ChuckSmith.