Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhancement: Theorems, definitions, and numbered equations. #432

Open
tOgg1 opened this issue Dec 10, 2015 · 3 comments
Open

Enhancement: Theorems, definitions, and numbered equations. #432

tOgg1 opened this issue Dec 10, 2015 · 3 comments

Comments

@tOgg1
Copy link

tOgg1 commented Dec 10, 2015

For some (many) of the mathematics compendiums, having some more clear markup for theorems, definitions etc. would be great. There are a bunch of ways these could be styled, which definitely justifies a discussion.

Also, having these (along with equations) numbered, and being able to refer to them, is also ideal for a lot of the same class of compendiums.

@stianjensen
Copy link
Member

The latex library we use, mathjax, supports automatic equation numbering:
http://mathjax.readthedocs.org/en/latest/tex.html#automatic-equation-numbering

Enabling this would mean all equations on a page would get a number assigned, and I believe it should be possible to refer to them from the text.

@stianjensen
Copy link
Member

As for theorems and definitions, the closest thing we have today are blockquotes.
Could they be sufficient for this use case, or are some other special features needed?

For reference, blockquotes are created with the following syntax:

> This is a blockquote

and rendered as

screenshot 2015-12-10 15 43 01

@tOgg1
Copy link
Author

tOgg1 commented Dec 10, 2015

Yes I am aware of the blockquote feature. They are okey as is, but lack:

  1. (Very subjective) Proper formatting, I much prefer Math SE's blockquotes. See for instance this link.
  2. A distinguishing factor for theorems, conjectures, lemmas, corollaries etc. This can be introduced by the user by explicit numbering/naming though.
  3. Numbering. For short articles or answers (as on Math SE) this is rarely necessary. However for larger compendiums, such as this, or this, being able to number and refer back to a given theorem is very handy. This is particularly relevant for courses which are very sequential in nature, in the sense that definitions and theorems from one chapter is relied upon and used a lot later.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants