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

Start adding markdown #3643

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion chapters/annotations.tex
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,9 @@ \subsection{Class Description and Revision History}\label{annotation-info-revisi
The \lstinline!revisions! documentation may be omitted in printed documentation.
\end{nonnormative}

If the string starts with the tag \lstinline!<html>! or \lstinline!<HTML>! the entire string is HTML encoded (and is assumed to end with \lstinline!</html>! or \lstinline!</HTML>! and shall be rendered as HTML even if the end-tags are missing), otherwise the entire string is rendered as is.
If the string starts with the tag \lstinline!<html>! or \lstinline!<HTML>! the entire string is HTML encoded (and is assumed to end with \lstinline!</html>! or \lstinline!</HTML>! and shall be rendered as HTML even if the end-tags are missing).
Otherwise the entire string is seen as GitHub flavored markdown \textcite{GitHubFlavoredMarkdown}, including display math using a subset of \LaTeX.
For backwards compatibility non-HTML text can be rendered as is instead of as markdown.
The HTML encoded content may contain links.
For external links, see \cref{external-resources}.
Links to Modelica classes may be defined with the HTML link command using scheme \lstinline!Modelica! (using its lower case form in the URI, see \cref{external-resources}), e.g.,
Expand Down
7 changes: 7 additions & 0 deletions mls.bib
Original file line number Diff line number Diff line change
Expand Up @@ -101,3 +101,10 @@ @InProceedings{Buerger2019SelectiveModel
address = {Regensburg, Germany},
url = {https://doi.org/10.3384/ecp19157277},
}

@Manual{GitHubFlavoredMarkdown,
author = {MacFarlane, John and others},
title = {GitHub Flavored Markdown Spec, Version 0.29-gfm},
year = {2019},
url = {https://github.github.com/gfm/},
}