(anonymous guest) (logged out)

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

Sponsored by the Wiki Symposium and the Nuveon GmbH.

 

Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-7) was last changed on 19-Oct-2007 01:18 by 207.171.180.101  

This page was created on 08-Mar-2007 10:22 by ChuckSmith

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 14 added 18 lines
==== Proposal ====
* //Where:// everywhere Creole markup is interpreted, i.e. everywhere except in
preformatted blocks and inline nowiki.
* //Effect://
** when the next character is a letter (a-z or A-Z) or a digit (0-9), the backslash is not considered as an escape character and both the backslash and the letter or digit are preserved in the output
** when the next character is a space, a tab or an end of line, both the backslash and the next character are consumed and a linebreak is generated
** in all other cases, the backslash is discarded and the following character is written verbatim to the output.
* //Rationale://
** rules are simple
** a single character is escaped, which corresponds to what authors want (they want to control characters in the output stream, not to preserve entire Creole markup sequences) and is robust with respect to other Wiki markup and future evolution
** the backslash can still be used in most Windows paths where it is usually followed by letters or digits
** the definition of letter and digits (7-bit ASCII or 7-bit UTF-8) is simple to implement and to understand
** backslash itself does not need a different escape mechanism
** linebreaks can move to the end or beginning of a line without problem
** white space at the end of lines, which is invisible, has no effect
** preformatted blocks and inline nowiki can still contain unescaped backslashes, which is important because backslashes are very common in many programming languages; their end tag (triple-right-brace) can already be escaped
At line 43 added 19 lines
* conflicts with some existing markup involving tilde (strike-out or emphasis)
* Several shells use ~ to stand for the user's home directory, and refer to files using ~/.emacs, for example.
==== Proposal ====
* //Where:// everywhere Creole markup is interpreted, i.e. everywhere except in
preformatted blocks and inline nowiki.
* //Effect://
** when the next character is a letter (a-z or A-Z), a digit (0-9), a space, a tab or an end-of-line, the tilde is not considered as an escape character and both the tilde and the letter or digit are preserved in the output
** in all other cases, the tilde is discarded and the following character is written verbatim to the output.
* //Rationale://
** rules are simple
** a single character is escaped, which corresponds to what authors want (they want to control characters in the output stream, not to preserve entire Creole markup sequences) and is robust with respect to other Wiki markup and future evolution
** the tilde can still be used in most URLs where it is usually followed by letters or digits
** the definition of letter and digits (7-bit ASCII or 7-bit UTF-8) is simple to implement and to understand
** tilde itself does not need a different escape mechanism
** linebreaks can move to the end or beginning of a line without problem
** white space at the end of lines, which is invisible, has no effect
** preformatted blocks and inline nowiki can still contain unescaped tildes, which is important because tildes are very common in many programming languages; their end tag (triple-right-brace) can already be escaped
Version Date Modified Size Author Changes ... Change note
7 19-Oct-2007 01:18 4.095 kB 207.171.180.101 to previous Fixed grammar
6 03-Apr-2007 23:55 4.097 kB 84.75.130.155 to previous | to last Added two more disadvantages.
5 13-Mar-2007 10:11 3.905 kB ChuckSmith to previous | to last removed "consequence", will explain on Talk
4 08-Mar-2007 11:11 4.007 kB YvesPiguet to previous | to last No escape in nowiki rationale, minor correction
3 08-Mar-2007 10:57 3.568 kB YvesPiguet to previous | to last Detailed proposals
2 08-Mar-2007 10:39 0.932 kB YvesPiguet to previous | to last Switched h3 and h4
1 08-Mar-2007 10:22 0.928 kB ChuckSmith to last please discuss
« This page (revision-7) was last changed on 19-Okt-2007 01:18 by 207.171.180.101