Quoting wasn't discussed yet. It's not even clear yet whether we need it in Creole.
There are two kinds of quotes, similar to two kinds of preformatted text. Inline quotes are made in HTML with <q> tags, block quotes with <blockquote>.
The traditional rendering of these elements is:
Interesting idea, Radomir, as it resembles preformatted text and allows both inline and block quotes. I also like the idea of associating a "source" to a quote, better if not necessarily a link. But using " chararacters could create problems, as they're often converted to curly quotes in word processors. From my personal point of view, quotes are fundamental. My target is more about forums and discussions than real wikis. But, after all, wouldn't a standard wiki syntax be great for those, also? OLPC and Markdown have blockquotes, and they use >, too. Unfortunately, http://www.wikimatrix.org doesn't help to compare quote syntaxes. -- MicheleTomaiuolo, 2006-09-22 This seems to be the most widespread and traditional use:
The e-mail style is not the fastest to type, but it's a well extabilished rule not only in emails but also in other text-based documents. I can notice that prefixing signatures with two '-' signs is a widespread practice, and in my opinion it should be formalized. It approximates quite closely the semantics of the HTML ADDRESS element. Mozilla suggests to use ADDRESS in quotations, too: http://www.mozilla.org/contribute/writing/markup#quotations The example above is interpreted correctly by the experimental Text_Wiki_Creole parser. See my page. -- MicheleTomaiuolo, 2006-09-25 I also know quite a lot of wikis use a colon instead of a greater than sign to show indention as the following:
I'd like bring this topic back, as we probably need quoting. It's probably good to have both inline and block quotes. The fact that MSIE incorrectly ignores the <q> tags has nothing to do with it -- after all, there are many ways to actually render the quotes (see http://www.alistapart.com/articles/qtag/), and one doesn't even have to use HTML. For inline quotes, we have four options:
- enclosing in (localized) quote characters in case of <q> (not supported by MSIE)
- indenting in case of <blockquote>>> (some e-mail readers also add a vertical bar along the text)
This is smaple paragraph. It conatins """an inline quote""". There is also a block quote below it: """ This is a block quote. This is a second paragraph of it. """[[http://my.quotes/blockquote|taken from my quotes]]Yes, " is supposed to be not used. But it fits so well... -- RadomirDopieralski, 2006-09-22
Interesting idea, Radomir, as it resembles preformatted text and allows both inline and block quotes. I also like the idea of associating a "source" to a quote, better if not necessarily a link. But using " chararacters could create problems, as they're often converted to curly quotes in word processors. From my personal point of view, quotes are fundamental. My target is more about forums and discussions than real wikis. But, after all, wouldn't a standard wiki syntax be great for those, also? OLPC and Markdown have blockquotes, and they use >, too. Unfortunately, http://www.wikimatrix.org doesn't help to compare quote syntaxes. -- MicheleTomaiuolo, 2006-09-22 This seems to be the most widespread and traditional use:
> This is a block quote. > Every line of it begins with one or more > characters. > > Paragraphs within it are separated with lines containing only the > characters and whitespace. Long lines wrap around making it hard to see where the quote ends. > * Should lists also be supported inside quotes? >> How about quotes inside quotes? > -- Source can be indicated with standard e-mail signature mark. > Empty line marks end of blockquote and beginning of a next one.-- RadomirDopieralski, 2006-09-22
The e-mail style is not the fastest to type, but it's a well extabilished rule not only in emails but also in other text-based documents. I can notice that prefixing signatures with two '-' signs is a widespread practice, and in my opinion it should be formalized. It approximates quite closely the semantics of the HTML ADDRESS element. Mozilla suggests to use ADDRESS in quotations, too: http://www.mozilla.org/contribute/writing/markup#quotations The example above is interpreted correctly by the experimental Text_Wiki_Creole parser. See my page. -- MicheleTomaiuolo, 2006-09-25 I also know quite a lot of wikis use a colon instead of a greater than sign to show indention as the following:
: This is a block quote. : Every line of it begins with one or more : characters. : : Paragraphs within it are separated with lines containing only the : characters and whitespace. Long lines wrap around making it hard to see where the quote ends. : * Should lists also be supported inside quotes? :: How about quotes inside quotes? : -- Source can be indicated with standard e-mail signature mark. : Empty line marks end of blockquote and beginning of a next one.-- Anonymus
I'd like bring this topic back, as we probably need quoting. It's probably good to have both inline and block quotes. The fact that MSIE incorrectly ignores the <q> tags has nothing to do with it -- after all, there are many ways to actually render the quotes (see http://www.alistapart.com/articles/qtag/), and one doesn't even have to use HTML. For inline quotes, we have four options:
- Try to detect quotes based on position of the characters and groups of characters commonly used for quoting, like "`", """, "''", ",,", ">>", "`", "``", "<<", etc. This is tricky even in normal text, especially when "'" is involved. It's even harder for jargon text that can contain various additional code (the code should be theoretically always contained in nowiki markup, but that's not always practiced). For example: "quote", 'quote', `quote', ''quote'', ,,quote'', >>quote<<, <<quote>>, ``quote'', etc.
- Use formally defined markup for the quotes, resembling the one used traditionally, but more restricted, to ease parsing. For example, I use ,,quote'' on my wiki. This has a problem, as most of the "traditional" quoting characters are not supposed to be used in Creole for markup (see Terms).
- Use whatever markup is used for block quotes, the same way that preformated blocks and nowiki share markup, for example [[[quote]]].
- Use formally defined, yet artifical markup, for example ~~quote~~ .
- Use a "leading" character or indentation on every line of the quoted text. This is especially known in e-mails, with the ">" or ":" characters, or a combination of them. Normally, the amount of characters signifies the nesting level of the quote, similar to lists in Creole. I don't think we need multilevel block quotes.
- Use a parenthesis-like syntax, similar to preformatted blocks in Creole. This makes it much easier to quote long texts, and also to adjust the line length of the pasted text.
- Do not specify markup for inline quotes.
- Use one or more colons at the beginning of a paragraph to indicate that the paragraph is an indented block, number of colons equals nesting level.
# First paragraph of item one : Second paragraph of item one # First paragraph of item twoI see no sane way to handle this correctly and keep the numbering of lists the way it is expected -- we best avoid this. I fail to see how using ":" instead of ">" makes it better -- it has all the disadvantages of ">", plus makes it more weird and less compatible with e-mails. Isn't it a little short-sighted to advocate certain markup just to make a one-time job for a single person easier? Then again, I think we don't really want to be compatible with e-mails in this case. I mean, e-mail quoting serves a totally different purpose than normal text quoting -- when you quote an e-mail with some ">" in it, you most likely want the ">" characters preserved! The exact rendering of the document is left to the engine. You can use the "<q>" tags alone, or with the tricks described in the article I linked to, or just put the HTML entities for the quoting character. You can even do a server-side browser detection if you feel like it. You still need a formal markup for the quotes -- because even for plain English text the auto-detection of the characters is not possible in every case (consider "'Tis a fools' errand"), and we don;t want to make Creole specific to the English language. Making it a markup for whole quote, rather than for the single characters seems saner and less prone to errors. -- RadomirDopieralski, 2006-01-01 I don't have a strong feeling about ':' vs '>'. My point is that '>' won't be compatible with emails anyway under the above proposal, because email uses '>' at the beginning of every line, while the proposed markup only includes the markup at the beginning of the paragraph. I still think that inline quote markup is not quite compatible with the goals of Creole. For one, it violates NotNew because there is no existing wiki that uses it. For two, the preferred rendering is dependent on locale, so that's one more thing for people to (mis-)configure. But again, I don't have a strong feeling about this and would find it a useful way to get my beloved curly quotes if consensus developed here that it did belong in core Creole. The discussion of presentation vs. semantic markup belongs on a different page, so I have created Wiki markup has presentation flavor. -- Raph Levien 2007-01-01 I think '>' at the beginning of a line might work. And for people used to old-school email clients will think of it as "principle of least surprise". But modern email clients rarely expose this, using indentation, color, and border-left instead. For newcomers, therefore, using '>' does not have any significant benefits. Using ':' would at least be recognized by all users coming from a Usemod derivative wiki. (Personally, I'd still be interested in writing an Oddmuse extension that uses leading whitespace to determine indentation.) -- Alex Schroeder Radomir sees a problem with this:
# First paragraph of item one : Second paragraph of item one # First paragraph of item twoBut I see it as a pretty reasonable solution to multi-paragraph list items, and don't see any serious problems implementing it. Sure, the algorithm for converting to (X)HTML is not exactly trivial, but not any worse than other things I've seen proposed, for example to find the end of preformatted blocks. Implementation-wise, treat all three of :*# as forms of indentation, with the number of characters indicating the level of indentation. The bullet or number is (from this point of view) extra decoration on the indented block. I was going to write up the algorithm in pseudocode, but I think I'll just implement it Python, then it'll be easy to play with test cases and see exactly how complicated it turns out. -- Raph Levien 2007-01-07 Just a random thought, how about making ":" just into a third kind of list, a bulletless list. MoinMoin has something like this, they use "." for that. This could be also an answer for people complaining on the forced newline -- from personal experience I can see that they often miss it when trying to make this kind of "bulletless list" of links on a page. This would also solve another problem I have with indented blocks -- the fact that there is no markup for it in HTML, XHTML, DocBook or LaTeX. Didn't UseMod use that braindamaged format derieved from definition lists for marking indeted block, by the way? :) -- RadomirDopieralski, 2007-01-08 Ok, the implementation is live now. You can see the results at http://ghestalt.ghilbert.org/wiki/NestedLists, and the relevant code is in ghmarkup.py. Most of the logic is in the ListState class, which I think is not too bad considering the richness of markup it supports. The results don't pass XHTML validation, because that requires <ul><li><ul> to introduce a nested list, while I just do <ul><ul>. This should be fairly easy to fix. I don't mind if you think of this "indented block" markup as really meaning "bulletless list." As you point out, MoinMoin renders it as <li style="list-style-type:none">. I think it's perfectly fine if we leave the choice between that and, say, <blockquote>, to the implementor. I also don't mind if the markup character is "." rather than ":", perhaps to emphasize the fact that it's a list. I'm not familiar with UseMod history, but don't you think adapting things that speakers find useful but experts find "degraded" to be entirely within the spirit of creole? -- Raph Levien 2007-01-07 This is very tricky. When an user say he wants something, and he describes the looks of it, it's rarely the looks he's actually after. When they say "I want this text to be black", pointing at a fragment of black text on white paper, I obediently make the selected fragment of text bold. Another time, when an user points at a line of text and says he wants it bold, I obediently turn it into a chapter heading. It's easy. Once an user came and said: "I want indentation here, only not indented." Some thinking and examining the provided text, together with a sample of intended output he found somewhere on a web, revealed that he wanted a blockquote, only not indented, but with some picture added to it instead as a mark of it being a quote. People describe looks when they talk, but this doesn't mean that they always mean the looks. As for the spirit of Creole, I understand it has two goals:
- allow to exchange text of pages between wikis -- in practice this only requires consistency and semantic-ish markup
- allow to contribute to wikis without knowing its markup or local traditions -- this means that I need markup for relevant parts of my text: semantic markup, as I don't know the local tradition according to which putting a footnote next to someone's name is a horrible offense (this is not made up!).
- RadomirDopieralski, 2007-01-08
<ul> <li>Item 1<br /> Line 2 of Item 1 </li> </ul>vs
<ul> <li>Item 1 <p>Second paragraph</p> </li> </ul>I would say that a generalization is in order :
Break | Markup |
---|---|
Implicit line break | Not supported |
Forced line break | \\ Double backslash |
Implicit paragraph break ("normal behaviour") | Two consecutive newlines |
Forced paragraph break | \\\ Triple backslash |
\\(double backslash) and \\\ (triple backslash) could be used anywhere (not only in lists). I know that the \\\ (triple backslash) is a new markup but is there a Wiki out there that makes that difference already? IMO, they should. (Should we move this discussion to Lists and Line Breaks?) -- EricChartre, 2007-01-10
- I just saw that my suggestion below is redundant with the first one at the top of the page... -
::: Quoted text :::Generalization again as it could be used inline or alone at the beginning of a line. In the former case, the rendering would be similar to emphasis. In the latter, it would be a block quote. It is a matter of semantics vs presentation... Advantages
- One markup for quoting (inline or block)
- Works the same way as preformatted
- Makes a strong differenciation between presentation markups (emphasis) and semantically-oriented one (quote)
- Same problems with parsing as preformatted blocks
- New markup?
- Is there any existing wiki that does it this way?
- EricChartre, 2007-01-10
This is a normal paragraph. : Top-level quote. : Second paragraph of the same quote (linefeed is ignored). :: A nested quote. : Top-level quote continues here. : And this is a second top-level quote.This way, one can easily reformat source code with wordwrap, without caring about markup which would be moved inside lines. -- YvesPiguet, 2007-02-08 I'd like to note that e-mail ">" (also ":" or "|" are used!) is technically not a block quote. It's traditionally used for something completely different -- quoting the text we are responding to -- not for including quotations and excerpts from external sources. I've encoutered this style used for block quotes only 2 or 3 times in my life, and it was jarring and unnatural for me -- it seemed as if the author attributed the quoted text to me. Much more widespread (among experienced users) and distinctive way of marking up quotetions in e-mail and news is the use of "+v" before the quoted text and "-v" after it, alone on a line. But I don't recommend it for Creole. Technical shortcomings make the ">" style practically useless for editable and automatically wrapped text on the wiki. It's awkward, adds a lot of user's work, looks ugly and has poorly readable. Personally I think it's unacceptable. I don't understand why would you want to nest block quotes and how would it be presented on wikis that have chosen not to indent quotes, but instead use one of several other traditional ways of marking block quotes: different font, background, color, italics, decorative quotes. There is simply no such thing as a nested block quote. -- RadomirDopieralski, 2007-02-08 I'm not saying that I like nested quotes (actually I don't). But they exist, and some people find them useful. They are (ab)used in forums and discussions, for example. Using ">" or ":" doesn't make a big difference for me. It's a matter of convenience, popularity, conflicts etc. Acceptance, at the end. What's important is that quoting or indenting (I wouldn't like to distinguish them) is allowed by most wikis. It's popular in forums, blogs, discussions. Users would certainly benefit from a unified syntax. -- Michele Tomaiuolo, 2007-02-08 So Radomir, would you accept one or more colons at the beginning of paragraphs (not lines) as in the example above? If you do, we could make it a proposal to provoke more feedback... Note that I'd still like to use initial colon for <dd> in HTML. But I don't think there is any conflict; <dd> must follow <dt> (lines beginning with a semicolon) in definition lists. -- YvesPiguet, 2007-02-08 I gradually grew to believe that there is no special markup needed for block quotes, as well as for definition lists, by the way. There are many wiki engines that seem to pursuit a 1:1 compatibility with HTML and introduce markup that mirrors the HTML tags. I don't think we really need special markup for these kinds of elements when they can be easily marked with patterns consisting of other markup. You can easily indicate a block quote by surrounding a whole paragraph with quotation marks. There is no need for special markup for that and it works equally well with just plain text (users will see that it's quoted), simple wiki parsers (normal paragraph with quotation marks) and sophisticated parsers (they might attempt to detect such patterns and render the page differently, using blockquote tags for example) and text-processing scripts (as long as you can distinguish the quotes). Similar deal is with definition lists -- even google spiders parse <li><b>foo</b> bar</li> as <dt>foo</dt><dd>bar</dd>. Sophisticated parsers can do it too, while simple ones will not lose anything. Finally, there is a question of popularity. I did a little survey among 5 of my website-making student frieds (it's the kind that writes html in notepad). One of them knew about the blockquote tag. None of them knew about definition lists. Asked about how they'd format a definition list in HTML, two of them suggested headings for terms and paragraphs for definitions, the rest would just use a table. I do recognize that the ">"-style text formatting is widely used in forums, e-mails, usenet and message boards. It's also used on some wikis to build threaded conversations. But they are not block quotes. If we provide markup for block quotes, it will be abused in similar way to how <em> and <strong> tags are abused due to "bad press" of <i> and <b>, and how headings are abused in absence of <large> tag. If we are going to have markup for this, I'd rather not call it "block quote". I also recognize that indentation is a very handy tool, useful for marking up all sort things: block quotes, definition lists, threaded discussions, side notes, editor's comments, etc. However, all of these things have also other traditional representations, available without the use of special markup. That's why I think that there should be markup for indentation available in the additions to Creole (see CreoleCoreAndAdditionsProposal), but not necessarily in the core. On the other hand, I still believe that a standarised way of marking inline quotes (not necessarily only quotations, it also applies to Wikipedia:Scare_quotes) would greatly benefit the mixed audience of various wikis. Markup like ``foo'' or ,,foo'' has little chance of conflicting with anything commonly used. -- RadomirDopieralski, 2007-02-08 I guess I must say clearly I don't want a perfect mapping between Creole and HTML; I'd much prefer Creole to remain simple. HTML isn't even my primary target. However, I think DL lists are much more useful than numbered lists when you don't have any markup for references (actually I don't see any use for numbered lists in Creole). Concerning indenting, it seems that it's heavily used in discussion pages on WikiPedia to emulate threads, so if I were the one to decide, I wouldn't relegate it to additions. -- YvesPiguet, 2007-02-08 Yeah, numbered lists (I mean the <ol> kind, not the kind with server-side generated numbers) are pretty much useless on the web, except for maybe two cases: tables of content and when you want to have the list items counted automatically. Continuing on the "use combination of markups to get what you need" idea, if we had the ":" indentation proposal from above implemented in form of bulletless lists, you could simply write:
:1 first :2 second ::2.1 et ceteraAnd this is human-readable, renders nicely, can be parsed by data-harvesting scripts easily, and allows you to refer to the particular items on your lists in the following text. As for definition lists, I agree that they come in handy. I don't understand why they are not widely used, but they are not. Maybe they are just not recognized as a separate construct by the users. At least it seems so to me. They are not going to be used much unless the markup for them will be as simple as:
the term: the definition-- RadomirDopieralski, 2007-02-09 It isn't much worse:
;the term: the definitionWith your proposition, we have stealth markup which isn't necessarily easier to understand for the user, imo. -- YvesPiguet, 2007-02-09 Actually, Mediawiki indentations and quotations are not the same thing. They're semantically very different.
- In the first case, we've a remark, a comment of the user addressing some precise part of the current document. An editor's introduction before an article is a good example of a remark.
- In the second case, we've a quotation//, something produced by another person, which probably the user is going to talk about in the document.
[[[ Yere I met elvis his told me [[[ I love hamburgers ]]] ]]]. Finally, all quotes should be attributable so the general format would be: [[[quoted text |Author]]] or ''' Quoted text |Author''' Did you hear what the DJ said he was told by elvis:-
[[[ Yere I met elvis his told me [[[ I love hamburgers |Elvis]]] | DJ ]]]. -- Isonomia
Add new attachment
Only authorized users are allowed to upload new attachments.