(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]

Discussion on: "In science and engineering, superscript and subscript is very common. It is semantic, not a formatting issue."

Radomir: However, the terms used in science can always be read out loud, so they have their, somewehat more elaborate, replacements ("m²"="square meter", "H₂O"="Dihydrogen Monoxide", "∑ₓ₌₀ⁿx"= "sum of numbers from 0 to n", "⌬"="benzene ring", etc.) -- the symbols are only shortcuts created for use inside formulas.

Gregor: This is partly true, but a) some symbols like "x₂" are simply read as "x-two", which is not acceptable in writing, and b) scientific writing is governed by rules of conduct, which consider the spelling-out option often inacceptable. The point is: are non-programmers willing to use wikis or do they walk away back to their "Microsoft Word + Adobe PDF" preference?

Radomir: From my own experience (mainly math and physics, sorry), the symbols are used either when you refer to them used in formulas and figures or when you're lazy and using jargon that everyone should be familar anyways. Tha latter is often considered bad style, but it depends on conext, of course -- it can be a real time saver and allows you to get the idea across fast. This is important in wikis.

Then, if you already have the formulas, it is a good idea to use exactly the same technique to create the symbols when you refer to them -- so that they look the same, for example (LaTeX is going to render the formulas with its special fonts that are very different from the browser's ones, for example). It also saves the users learning new markup and thinking of several ways to achieve the same effect in different context -- they can just copy and paste.

I agree that a wiki should provide features needed by its community -- for a scientific wiki, a LaTeX or very similar extension is simply a must. I even listed a proposed markup in the HintsOnExtending -- the same that is used in LaTeX for embedding math: $x_2$. I believe it is at least as easy to type as x2 and has several additional benefits: the symbols appear exactly as in formulas, being distinguished from the main text, the markup is identical to that in the formulas and you can even copy parts of the text directly to/from your LaTeX sources. Plus the risk of any collisions or surprising effects is much lower.

On the other hand, a wiki dedicated to different topics, like gardening, will be much better off with just a simple filter converting commonly used phrases, like m2->m² or h2o->H₂O. As long as they are readable in the source form, the interoperability doesn't really suffer.

I always like to bring up the Sensei's Library as an example of a wiki that has its markup adopted to suit the needs of its community. One can hardly imagine such an extension in a core specification for all the wikis in the world.


Many markup languages to which Creole is going to be translated (mostly HTML) expect some degree of semantic (or at least screen reader friendly) markup, like indicating the LanguageOfText and marking AbbreviationsAndAcronyms: on the other hand, if Creole is going to support all useful HTML features, I'd rather use directly HTML whose syntax is more consistent.

What about proposing in Additions to reserve single angle brackets for HTML? Typically, it would be filtered to avoid abuses.

-- YvesPiguet, 2007-Sep-20

Yes, I tried to use neutral language as much as possible. Note however, that there are use cases of both denoting the language and using abbreviations in wikis, so I think it's worth our attention -- possibly to be dismissed, but at least discussed before that.

As to mixing HTML with wiki, I have two objections, on two different levels:

  • The > and < characters will appear in any technical text randomly on their own, both surrounded by digits and by letters. Sure, in a perfect world they whould all be in a {{{...}}} or $$...$$, but wikis are not perfect worlds. Reserving single character without any additional context (like "only at the beginning of a line") is imho a very bad idea.
  • Once you allow HTML (you can white list it, so it's fairly safe), all advanced users will be using HTML and the page will become read-only for new wiki users -- the exact opposite of the wikicreole goals.

-- RadomirDopieralski 2007-Sep-20

So if you have a markup suggestion... If it could be some kind of generic named attribute which could also be used with images, links and other elements, it would be nice. I know the resistance against names, but at some point, we're bound to run out of characters. Or should we use unicode? :-)

-- YvesPiguet, 2007-Sep-20

Add new attachment

Only authorized users are allowed to upload new attachments.

« This particular version was published on 20-Sep-2007 23:29 by YvesPiguet.