Start a new discussion

Not signed in

Want to take part in these discussions? Sign in if you have an account, or apply for one below

Site Tag Cloud

Vanilla 1.1.10 is a product of Lussumo. More Information: Documentation, Community Support.

• CommentRowNumber1.
• CommentAuthorUrs
• CommentTimeFeb 28th 2011
• (edited Feb 28th 2011)

Have added to HowTo a description for how to label equations

In the course of this I restructured the section “How to make links to subsections of a page” by giving it a few descriptively-titled subsections.

• CommentRowNumber2.
• CommentAuthorUrs
• CommentTimeMar 29th 2012

have added to HowTo right after the mentioning of the CodeCogs page also a link to the (new?) QuickLatex tool.

• CommentRowNumber3.
• CommentAuthorUrs
• CommentTimeSep 15th 2012
• (edited Sep 15th 2012)

I was reminded of some things that I had wanted to add to the HowTo page, and now I finally got around to doing so:

I added a new section How to organize and write content with new subsections:

• CommentRowNumber4.
• CommentAuthorUrs
• CommentTimeSep 15th 2012

I have also added a subsection:

• CommentRowNumber5.
• CommentAuthorUrs
• CommentTimeSep 15th 2012
• (edited Sep 15th 2012)

Oh, and now I have spotted and removed the subsection “How to ask questions”. I think we all agree that this initial idea we once had didn’t work out and should be abandoned, reproduced below just for the record:

[ begin obsolete old text ]

How to leave comments and questions

If you want to make a comment or question about a page without changing its main content, then edit the page and put your comment or question in a query block as shown in this example:

+-- {: .query}
How do I ask a question?
=--


which produces

+– {: .query} How do I ask a question? =–

Note that a query block should be less permanent than the rest of the page; once your comment is addressed or your question is answered, you can probably remove your query block.

If you want to ask a question of a specific person, then you can place a query block on their user page (which is just a page whose title is their name). You should be able to find all user pages here.

If your comment or question is more general than a specific page or person, then try the n-Forum. Previous discussions have been on the General Discussion page and on an entry at the n-Cafe. These previous discussions should not be added to but you may find your question answered there. Important answers are being migrated to this How To and the FAQ. As this is a Wiki, if you find an answer to your question and feel it should be added to one of those then do so.

[ end obsolete old text ]

• CommentRowNumber6.
• CommentAuthorTobyBartels
• CommentTimeSep 17th 2012
• (edited Sep 17th 2012)

That text shouldn't be removed entirely; it's still a formatting feature that's sometimes useful and should be documented.

The section has been edited bit by bit over the years as we've pulled away from heavy use of query boxes. It ought to start by pointing people to the Forum (instead of ending with this as it last did) and then show how to make a query box if people want to.

I will try to write a section like that now. … Done.

• CommentRowNumber7.
• CommentAuthorUrs
• CommentTimeFeb 7th 2018
• (edited Feb 7th 2018)

• CommentRowNumber8.
• CommentAuthorRodMcGuire
• CommentTimeJun 7th 2018

I don’t know what to do about the broken link on “Make tables, footnotes, etc” http://maruku.rubyforge.org/maruku.html#extra

• CommentRowNumber9.
• CommentAuthorTim_Porter
• CommentTimeJun 7th 2018

I mentioned that there was an invalid equation on that page on another thread.

• CommentRowNumber10.
• CommentAuthorUrs
• CommentTimeJun 14th 2018

prodded by discussion here I have added to the HowTo-page a section:

How to cite and record references

• CommentRowNumber11.
• CommentAuthorUrs
• CommentTimeJun 14th 2018

In order to improve the order-by-relevance of the material, I moved up the section How to make links to subsections

I see now that this has a little bit of overlap with the new section on how to put references that I just added, but it’s maybe still good to have the latter

• CommentRowNumber12.
• CommentAuthormaxsnew
• CommentTimeJun 14th 2018

This page is great, and I will definitely reference it in the future, but after about a year or two of editing here, I’m not sure I’ve ever seen it.

I think it would be very nice if the editing page always included a link to this page right at the top. The edit page has some nice markdown tips, but this page has stuff like table of contents and theorem environments that are less common.

• CommentRowNumber13.
• CommentAuthorUrs
• CommentTimeJun 15th 2018

I think it would be very nice if the editing page always included a link to this page right at the top.

That sounds indeed like a good idea: include a pointer to HowTo in the line on top of each nLab entry.

We will have to bring this to the attention of Richard. Probably he will see this here. If not, let’s remember to contact him about it.

• CommentRowNumber14.
• CommentAuthorUrs
• CommentTimeJun 15th 2018
• (edited Jun 15th 2018)

I noticed that the text under Software requirements was badly outdated.

I rewrote a bit, to the best of my knowledge, in particular I mentioned MathJax (which wasn’t around yet when that section was last edited!) But somebody more expert should please check, especially the following points:

• is installing STIX fonts still something one needs to do?

• what’s the latest on Opera supporting MathML? It said something about the “recent” version, but that will be long outdated now.

• Is it still true that IE (or any other browser) works with or needs the MathPlayer plugin? My impression is that this is a thing of the past?

Anyway, somebody who knows about this might want to start this section completely from scratch, with up-to-date information.

• CommentRowNumber15.
• CommentAuthorMike Shulman
• CommentTimeJun 15th 2018

I don’t think STIX fonts are needed… at least, I haven’t installed them on my new computer and things still look fine.

• CommentRowNumber16.
• CommentAuthorUrs
• CommentTimeJun 18th 2018

just downloaded the latest Opera-version to check. But it calls MathJax instead of rendering MathML natively. So I removed that outdated line regarding Opera that we had. Also removed the statement about IE needing MathPlayer.

So now it just says that Firefox is currently the only browser with native MathML support, the rest of the crowd falls back to MathJax.

Which is a pity. Since its last update Firefox has become ridiculous, tending to take several seconds for opening new windows.

(I followed the instructions that are offered online for how to work around this most unbelievable issue, but first of all I don’t actually want to clear my browsing history, as I am being advised, and it didn’t actually help for more than half an hour anyway. )

• CommentRowNumber17.
• CommentAuthorspitters
• CommentTimeJul 20th 2018

The howto still mentions the Stylish plugin. However, there have been problems with it spying on people. There is a replacement. As I’m not using the plugin myself, I won’t change the howto, but people using it (Mike?) may want to have a look.

• CommentRowNumber18.
• CommentAuthorMike Shulman
• CommentTimeJul 20th 2018

I’ve never used Stylish.

• CommentRowNumber19.
• CommentAuthorUrs
• CommentTimeJul 21st 2018

Bas, just add the very information that you just mentioned to the HowTo, then anyone using that plugin can check for themselves.

• CommentRowNumber20.
• CommentAuthorUrs
• CommentTimeOct 26th 2018

I have fixed the coding of “How to upload files” (it had only one instead of two hashes and hence didn’t show up in the ToC) and then I moved it further up in the list of items, where it seems to fit more logically

• CommentRowNumber21.
• CommentAuthorMike Shulman
• CommentTimeOct 29th 2018

At How to make links to subsections, some of the wikilinks inside verbatim displays are getting parsed when they shouldn’t be.

• CommentRowNumber23.
• CommentAuthorUrs
• CommentTimeJan 10th 2019

Excellent. Thank you!

I have further specified the pointer to the $n$Forum to a pointer to this particular thread here, to free the user of the need to create a new thread, come up with a decent thread title etc.

2. Good idea, thanks very much!

3. Updated instructions for adding commutative diagrams and images. Removed various deprecated methods, including all material on the SVG editor, which was removed from the codebase some months ago.

• CommentRowNumber26.
• CommentAuthorMike Shulman
• CommentTimeJan 20th 2019

Also remove link to SVG Editor web page.

• CommentRowNumber27.
• CommentAuthorRichard Williamson
• CommentTimeJan 20th 2019
• (edited Jan 20th 2019)

Add description of LaTeX syntax for theorem environments. Move ’Technical’ section to the bottom. Change instructions for ’how to remove a page’ to remove mention of the old making-the-page-empty method.

4. I think HowTo could still do with quite a bit of work, for example rearranging parts of ’How to organize and write content’ and ’Special typesetting features’ into one clean section which covers all typesetting, putting everything else, like CSS, how to ask questions, etc, in some other section. I’m also not sure about the ’Template’ page. I think now we could just link to a few particularly nicely constructed pages (many of them have a cohesive style, so it shouldn’t be too much of a problem).

• CommentRowNumber29.
• CommentAuthorRichard Williamson
• CommentTimeJan 20th 2019
• (edited Jan 20th 2019)

I’ve also not yet added the LaTeX syntax for table of contents or sectioning to the HowTo. I will also eventually tweak the sidebar to the right when one edits a page to cover a bit more.

• CommentRowNumber30.
• CommentAuthorUrs
• CommentTimeJan 28th 2019
• (edited Jan 28th 2019)

We should add a bunch of examples of tikzcd-diagram typesetting, with output in parallel to the source code, both for convenient copy-and-pasting for regulars, as well as a guide for newbies

But there is a weird bug: You’ll see that the very last line of the escaped code is lacking its backslash – that’s because when adding that backslash (in the escaped code!) I get an error message upon “submit”-ing the entry (?)

• CommentRowNumber31.
• CommentAuthorUrs
• CommentTimeJan 29th 2019

Am slowly beginning to switch my typesetting here to the new tikz-functionality.

Is there a way to use the existing equation numbering functionality for formulas created with tikzcd here?

• CommentRowNumber32.
• CommentAuthorAlec Rhea
• CommentTimeJan 31st 2019

Added explanation for how to format xymatrix diagrams.

5. Tweaked xymatrix examples according to a slight change in syntax. Also fix the ’bent arrows’ example, and add 2-cell example.

6. Make source of Tikz and Xymatrix examples visible on the page.

7. I have now fixed the issue mentioned in #30, also discussed in #43 here, to allow for the diagram code to be displayed verbatim. See here for the github commit.

As Urs suggested earlier in the thread, it would be good to collect together in the HowTo all common diagram shapes, e.g. commutative squares, triangles, 2-cells, …

8. Added how to centre/center using the new(-ish!) LaTeX syntax to the HowTo.

9. Some links in the “How to edit nLab pages in your favorite text editor” section did not work anymore. I put there some links to some Firefox addons that are convenient to my impression.

10. Elaborated a bit on captions for graphics when using imagefromfile, and added some advice on floating graphics.

The newer syntax for sectioning is still not documented.

12. As for troubles with h6. I don’t think that it is a feature that the “Theorem” shows up in the table of contents at HowTo#latex_syntax

13. Updating available theorem environments in the ’new’ syntax, i.e. the LaTeX-like syntax.

• CommentRowNumber42.
• CommentAuthorUrs
• CommentTimeJan 4th 2021
• (edited Jan 4th 2021)

Where the new environment-syntax was mentioned (here) with but a pointer to the page’s source, I have added display of the code that the reader needs to know.

Apparently the issue is that the new syntax doesn’t allow itself being escaped, but I worked around it:

$\array{ \mathrlap{ \backslash\text{begin}\{\text{theorem}\} } \\ & \;\; \mathrlap{\backslash\text{label}\{\text{SomeTheorem}\}} \\ & \;\; \mathrlap{\text{Some theorem.}} \\ \mathrlap{\backslash\text{end}\{\text{theorem}\}} }$

:-)

(So this won’t allow being copy-and-pasted usefully, but at least the reader gets to see what they need to see.)

• CommentRowNumber43.
• CommentAuthorUrs
• CommentTimeJan 4th 2021

(Oh, in fact, copy-and-pasting the code displayed in #42 works just fine.)

14. Nice, thanks!

• CommentRowNumber45.
• CommentAuthorUrs
• CommentTimeApr 1st 2021

re-worded and expanded the “How to start a new page” section (here), to make it clearer