My advice: Check to see what's installed on the machines that the school makes avialable to students. If Firefox is there, then tell them to use that if IE gives them problems.
]]>I used instiki for this course here.
The students said they found the wiki pages helpful.
I never thought of warning the IE users among them, admittedly, but I also never got a complaint on non-readable entries, so I figure they all used non-evil browsers :-)
]]>Ooh, that bothers me. I was hoping to use instiki for a course I'm going to be teaching this year. (So I'd be interested in hearing about your experiences sometime, perhaps over email.) I presume that you also need Administrator privileges to install Firefox, so anyone on a Windows machine without Admin privileges and only IE installed is out of luck. I guess one could try to configure instiki to use BlahTeX instead of MathML (now I'm thinking about course websites, not the nlab).
]]>No, but after Zoran's problem mentioned on the lab I thought it might not be a bad idea if I at least had a look to see what it looks like in IE. I'm also using Instiki for the course I'm teaching here and some of the students may be using IE. However, all my attempts were futile.
Smug? Me? Nah.
]]>Okay. Well, you are probably not using IE in the first place, are you?
]]>yes, it is quick and easy and free to install the "MathPlayer" plugin. That works very well with IE.
Not on my system it isn't! Apparently, you need administrative privileges to install it which I don't have on one of the windows systems I have access to. The other (on which I do have sufficient privileges) can't connect to my university wireless network so I can't download it, and if I transfer it across it wouldn't help as I couldn't see any pages!
]]>Concerning IE:
yes, it is quick and easy and free to install the "MathPlayer" plugin. That works very well with IE.
We should maybe add a highlighted notice to our welcome page with something like "If you don't see the mathematical typesetting on the $n$Lab at all or not in a pretty-printed fashion, you may have to download a plugin or use another browser alltogether. See here for details".
Well, since i said it, I sould do it. I'll do so now.
]]>I suppose "support" has to be used somewhat loosely in this context. For many people (certainly for me) it would probably be easier to read the raw itex than that. (-:
]]>(Example: became D x:x->x(x)x
.)
Are there any text-based browsers that support MathML?
Yes, links
(not lynx
).
Well, since we use MathML extensively, that already limits our accessibility noticeably, probably more than CSS does. Are there any text-based browsers that support MathML? I've been told that IE supports MathML if you install a plugin, but I haven't actually tried it -- from a practical point of view that would probably be the next most important browser to support after Firefox.
]]>I think that anyone who's reading the nLab in pure HTML has enough problems already that we can safely say that if they can overcome those then they're not going to be bothered by the difference between h1
and h2
! I guess one of the reasons for CSS is that the HTML spec is too limited and that h1
in one part of the page is not the same as h1
elsewhere. One place where this might be true (haven't checked it) is with text-only browsers (lynx, for example) and I don't know what they do with CSS. We probably ought to think a little about non-standard (i.e. non-Firefox!) access and how accessible we are.
Other than that, I agree with what Mike and Urs said. I think that we should have a go with the CSS and see what looks good, then if there is anything more that needs doing we can fiddle with the filters, but I suspect that actually we'll be able to do it all with CSS.
]]>We can take that point of view, but HTML does not. (Not that it's a big deal, since people generally read HTML+CSS, not HTML.)
]]>Perhaps we should take the point of view that an <h1 id="pageName">
is semantically an "h0"? I do think it would be better in principle to follow what is clearly intended by the Markdown syntax, namely that # is used for top-level headers in the text being written (the page name being outside of this text and thus at a higher level), and fix the big-and-ugly problem with css.
The reason that I start with ##
is strictly semantic; it is because there is already an <h1> on the page, so the next subordinate header should be <h2>. (I don't change what others have written, as long as it's consistent and I'm not redesigning the whole page.) Being less big and ugly is only a bonus.
Other than that, I agree with everything in Urs's comment (18). In particular, all of the various other concerns about the style of the headers can and should be fixed by improved CSS.
Incidentally, MediaWiki does automatic section numbering, not just in its TOCs but also throughout the text; it's just turned off by default for some reason.
]]>I don't know about the table of contents (though I agree it sounds a good idea in principle), but certainly the headers are distinguishable by CSS. The problem with using the top level headers in the main document (that is, using #) is that the code produced is an h1
which is the same as the page name. However, the h1
corresponding to the page name gets an id
tag ("pageName") which means that it can be selectively styled using CSS. Thus by using CSS we can apply one style to the h1
showing the page name and another to the h1
s in the page. That way, we can actually make the ones in the page look as if they were h2
s, for example. CSS is the answer!
As for section numbering, I'd imagine that Jacques' hack for theorem numbering could be adapted to that. Looking at a typical page source, I see that there's a certain amount of numbering going on already. I'd need to understand how the whole lot works a little better to be able to say whether it was difficult or not, but I'm strongly betting on "possible".
]]>Concerning markup for headlines:
I am among those who tries to consistently markup top-level paragraphs with a single #.
I agree that the way this is formatted by the software is suboptimal. but I'd think the conclusion to be drawn from this should not be that we start the first paragraph with double ##.
I think we should use the features as intended. If it doesn't come out right, we should try to fix the way the software works instead of starting to use funny workarounds. Can't this be done easily by tweaking the CSS features (maybe no, i amjust asking).
As Michael notes, there are more problems, such as that the difference between the formatting of ## headline ## and ### headline ### and #### headline #### is hard to spot and hence doesn't serve its purpose properly.
But this means first of all that using double ## instead of single # tries to work around one problem only to run into the next.
The only good solution here is that eventually we find a way to change the way the software goes about formatting of headlines.
Ideally, I'd think. an nth order headline should not only have an easily distinguishable (and nice) font, but also explicitly start with something like "II.3.a)" or whatever, maybe using indention, something that makes it crystal clear to the reader at which level he or she is reading.
And even more ideally, the software would automatically produce a clickable table of contents.
I have to admit that I can't really tell how likely it is that anyone finds a fix for this. But using hacks that wrok against the intended markup system makes me nervous. For instance it will make the source code that we produce less easily portable to other wikis.
]]>Maybe we should do a mathematical version of the CSS Zen Garden. Choose a page that has a good selection of headers, theorems, proofs, definitions, and the like (or devise one specially) and then play around with the CSS to see if we can find something that looks a little better than the "standard" one.
]]>Yeah, I often do that too. (-: But not everyone does. And regardless, it would also be nice to be able to tell the difference between ## and ### more easily.
]]>I try to use ## as the biggest header (same as Wikipedia, as it happens). The title up top is already an <h1> anyway, so it really seems more correct if the next header is <h2>. To some extent, this fixed the big-and-ugly problem.
]]>I second the suggestion of more variation in style between different headers. Maybe we could also make top-level headers in a smaller font; right now they look too big and ugly to me.
]]>Andrew,
let me try to reproduce the problem I had, because currently it's no longer presentable since I removed all numbering that caused problems for me.
Concerning the design question: yes, that's exactly how I am feeling, too. I feel a desire to get better formatted pages, but I am not really sure myself how that should work. That's why I am also not sure how exactly to reply to Toby's last comment.
Maybe it helps to start with concentrating on this specific problem:
on my private web there was some long bit of text. Then Jim stasheff came along and suggested that I mark one paragraph of it as "Remark" so that the reader would get an indication that that particular paragraph might possibly be skipped on first reading.
So I added a remark.environment from the theorem-proff etc environments lists to enclose that paragraph. But then notice that the formatting result was exactly null.
]]>I agree that we could do a lot with regard to design. We should use the fact that this is on the web to make it different to a printed page. Having one long page full of definition-theorem-proof is a bit dreary.
Over at Frolicher space then I've tried to tweak the basic design a little by putting definitions in boxes and indenting proofs, but while I think it's a bit better than the standard layout on the n-lab I don't think that it qualifies as a good design.
Presentation is important. Content is primary, but presentation comes a pretty close second. My basic problem is that I have no picture of what a good layout would be. Maybe we need to hire a graphic designer!
]]>Urs wrote:
On my private web I am having trouble with numbered theorems. When I try to refer via \ref{bigdeal} to a theorem labeled bigdeal it seems what I get after hitting submit is the display of "\ref" then grayish "bigdeal" with a clickable question mark trying to make me create a new entry titled "bigdeal" and then the closing "}" .
Can you give a link to the page where this is happening?
]]>