Open kadrlica opened 6 years ago
It was disabled intentionally, since I think the less than <
and greater than >
signs may appear quite often in the descriptions.
We can enable html, but then we need to type <
and >
for less and greater than signs.
Right now I see only one use of greater than in: https://github.com/lsstdarkmatter/dark-matter-graph/blob/a7346e5/data/data.yaml#L253
Definitely a good point. My first intuition is to go with the raw html; but I'll need to think about this...
Another choice is to use Markdown in the description field in the YAML file, which is certainly much easier for human to write...
In fact, how complicated do we think the description would eventually be? As the descriptions start to grow, maybe they are no longer suitable to be placed inside the yaml file.
A possibility is to have html files for each of the description. We can use the keys as the filenames and put them all under a subdirectory. The web app would then load corresponding description, similar to how it loads instructions currently.
I think that we will always want a brief description that can be displayed on the sidebar. I think that we may also want a more extensive summary (paragraphs of text and figures), but I think this augments rather than replaces the sidebar level quick description.
Sure. Then the question comes back to that to what extent we need to support rich formatting in the sidebar, given that they are just brief descriptions.
In this case, keeping brief descriptions pure text does not sound insane. People can still use markdown-like syntax in pure text to do emphasis.
If we do render the descriptions from markdown to HTML, then there's the question of which flavor of Markdown to use. For example, GFM is not particular science-friendly when one wants to say dark matter mass of m_DM~10 GeV to m_DM~100 GeV.
@yymao is there any way to render html text in the description text? For example, I was trying to bold something by adding the
<b>
tag, but this didn't seem to render.