At line 3 changed one line |
In the meantime, the simple escape mechanism proposed here for preformatted blocks, I believe, is both adequate and safe. If we don't end up with an escape character then this is the best alternative, without a doubt. Having said that, I will endeavour to work through my escape thinking over the next few weeks and input into any escape arguments. |
In the [[meantime]], the simple escape mechanism proposed here for preformatted blocks, I believe, is both adequate and safe. If we don't end up with an escape character then this is the best alternative, without a doubt. Having said that, I will endeavour to work through my escape thinking over the next few weeks and input into any escape arguments. |
At line 514 added 150 lines |
Thanks for your remarks; I've removed the example in the line break section (no more valid with multiline list items), and |
I've replaced "array" with "table" (my fault). I hope it's fine to fix these mistakes in 1.0; otherwise, there should be revisions |
(1.0a, 1.0b, etc.). |
|
List items can span multiple lines. |
|
-- [[YvesPiguet]], 2007-July-20 |
|
Excellent. Thanks Nick for the remarks! Yves, I trust you so it's fine if you fix mistakes in 1.0. I wasn't able to do so the last few days. Nick, the multiline list items came in quite late, see [[26JunMeeting]] and [[Creole 1.0 Poll]], so I guess we overlooked to change the mentioned rule in the spec. |
|
-- [[ChristophSauer]], 2007-Jul-24 06:03 (CEST) |
|
This discussion page is much too long. If there has been some consensus that condensed into creole 1.0, the old discussion here should be moved to some archival page and this discussion page should be about creole 1.0 as it is. |
|
The main page also has some contradictions in the change notes vs. the main spec. text and should be cleaned up: |
* escape char |
** The spec section should mention "The escape char is the tilde (~)." Currently you can only guess it from the examples. |
** The change notes talk about "the escape character" at one place and about "tilde" at another place. This should be changed to "the escape char" at both places if this was the intended meaning. |
** The change note "removed escaping closing nowiki triple curly brackets because this is now covered by the escape character" is unclear (removed WHAT escaping?) and contradicts the spec section about "Closing braces in nowiki" (the latter one says "lines with three closing braces which belong to the preformatted block must follow at least one space"). Decide, do we now use "~}}}" to escape or " }}}"? |
|
For people not knowing mediawiki, the placeholder stuff is unclear. |
|
-- Thomas Waldmann, 2007-08-09 |
|
I've moved Thomas remarks at the end to keep chronological order. |
|
I agree with all your remarks. Thanks! I'd also move the list of changes at the beginning of [[Creole 1.0]], because they're irrelevant |
there in what should be a reference document. |
|
I've made the changes you propose, except for //the escape character" at one place and about "tilde" at another place// which |
I'm not sure to understand."Removed escaping..." is obsolete; I've removed it. |
|
The placeholder is unclear to many people. An implementation which uses it would be helpful to evaluate it. I guess it could |
contain a number which would refer to a table of unsupported stuff when converting from some richer markup language like |
mediawiki, to permit restoring them when saving modifications. Whether it would be practical is an open question to me. |
|
I leave the decision to move this discussion or the list of changes to somebody else. |
|
-- [[YvesPiguet]], 2007-Aug-9 |
|
Creaole and other wiki-syntaxes like it really fall short if you have lots of external (and therefore often long) links. This is especially the case when using Creole as a Blog-Language, or when writing scientific documents (or other texts where you have to carefully cite your sources). |
|
Therefore it would be great if the parsing rules could be relaxed a bit, so that if a link with description has the link at the second position and the first is clearly not a link, it still gets shown sensible. |
|
That would help greatly. |
|
-- [[http://häcker.net| Martin Häcker]] |
|
What's the problem? |
|
-- [[YvesPiguet]], 2007-Sep-20 |
|
how would additional links like the ones used in http://trac.edgewall.org best fit into creole? --ThurnerRupert |
|
Which additional links? |
|
-- [[ChuckSmith]], 2007-Okt-17 15:08 (CEST) |
|
What about underline and strikethrough? |
|
-- Mo 2008-Mar-14 |
|
Underline is an [[CreoleAdditions|addition]]. Strikethrough is not defined (yet?). It's been discussed at different places, though; do a search for "strike". |
|
-- [[YvesPiguet]], 2008-Mar-16 |
|
== Self-contradiction in escape character |
|
I find it self-contradicting or at least ambiguous. On one hand, it says, that escape character escapes just the following character, i. e. |
{{{ |
~http://localhost |
}}} |
should be rendered as |
{{{ |
http:<em>localhost</em> |
}}} |
On the other hand it says a tilde escapes the whole URI. |
|
It is obscure, whether |
{{{ |
~** bold ** text |
}}} |
should be rendered as |
{{{ |
** bold ** text |
}}} |
(escaping the whole pattern, as an URL) or |
{{{ |
** bold <strong> text </strong> |
}}} |
If escaping URI as a whole is an exception, it should be explicitly marked as such. |
|
-- [[IvanFomichev]], 2008-04-04 |
|
In front of something which is converted automagically, such as a URL (but not explicit markup), it prevents the conversion. Elsewhere (except in nowiki, preformatted and inside URL, or in front of a blank), it escapes a single character. |
|
-- [[YvesPiguet]], 2008-04-04 |
|
The EscapeCharacterProposal is somewhat different from the final spec. I don't like ~~ in URLs be considered escapes. They are common in user URLs and there is no need escaping a character that is not considered special by Creole. |
|
* {{{http://example.org/~user/}}} -> http://example.org/~user/ |
|
On this Wiki, ~~ escapes the URL, but the URL is parsed as inline text: |
|
* {{{~http://example**.org**/~user/}}} is rendered ~http://example**.org**/~user/ |
* {{{~http://example//.org///~user/}}} is rendered ~http://example//.org///~user/ |
|
Another test; Creole formatting inside URLs: |
|
* {{{http://example//.org///~user/}}} -> http://example//.org///~user/ |
* {{{http://example**.org**/~user/}}} -> http://example**.org**/~user/ |
|
-- [[LarsChristensen]], 23-May-2008 |
|
Please don't consider what this wiki is doing to be "the final spec". The implementation isn't perfect. You've pointed out a few deficiencies here for sure. Tildes in urls are fairly common and Croele should treat them as any other character. |
|
[[http://werkzeug.pocoo.org/e/simplewiki/tildes_in_urls|This wiki]] uses Creole and it does a better job with your tests. ;) |
|
-- [[StephenDay]], 23-May-2008 |
|
= Example with two opening braces? = |
|
The current (12-May-2008) page gives the following example for inline NoWiki markup: |
|
{{{ |
{{if (a>b) { b = a; }}} |
}}} |
|
There are only two opening braces. Is that intentional? |
|
-- [[Ben Kovitz]], 12-May-2008 |
|
The parser is having trouble with this. There should be three opening braces and four closing ones. |
|
An admin needs to unlock the page to fix it (or add a comment that it is not displaying correctly). |
|
-- [[StephenDay]], 13-May-2008 |
|
Thanks for the clarification. I'm implementing the ~{{{ just as a token, and not bothering trying to match up braces inside the Nowiki text with any braces that occur before the ~}}} appears. |
|
-- [[Ben Kovitz]], 13-May-2008 |
|
== Use of TT tag for representing code |
For code rendered using the {{{{{{ }}}}}} technique, would it not be better for the markup to be <code></code> tags rather than <tt></tt> tags, as the former gives semantic meaning and allows the browser to choose an appropriate font, wheras the latter is simply a display tag? |
|
-- M1ke, 18-May-2008 |
|
Creole doesn't specify that <tt></tt> be used, it's just a suggested implementation. <code> could be used, as could <span>, or no markup at all (or whatever). |
|
-- [[StephenDay]], 18-May-2008 |