diff --git a/docs/_markbind/variables.md b/docs/_markbind/variables.md
index 2dfa5f3779..8e18f53a0c 100644
--- a/docs/_markbind/variables.md
+++ b/docs/_markbind/variables.md
@@ -1,9 +1,3 @@
-{{ baseUrl }}
-`
`
-
-{% for item in [1, 2, 3, 4] %}
- `Item {{ item }}`
-{% endfor %}
-`
-# {{ title }}
-Author: {{ author }}
-
+{% raw %}
+```html
+# {{ title }}Click [here]({{ showBaseUrlCode }}/userGuide/reusingContents.html).
-2. ``
+{{ icon_example }} Here's how to specify a link to (1) a page, and (2) an image, using the {% raw %}`{{ baseUrl }}`:
+
+1. `Click [here]({{ baseUrl }}/userGuide/reusingContents.html).`
+2. ``
_markbind/ folder work correctly across the entire site, they should be written as absolute paths, prepended with {{ baseUrl }}.
+
+To ensure that links in the _markbind/ folder work correctly across the entire site, they should be written as absolute paths, prepended with `{{ baseUrl }}`.
{{ MAIN_CONTENT_BODY }}
-
` elements, markdown code fences and inline code though, which markbind automatically
+adds `v-pre` for.
+
+However, this does not change the need for `{% raw %}{% endraw %}`. Meaning, you can still use variables within your code!
+{{ variable_name }} will act as per normal.
+
+Note however, that variable interpolation syntax {% raw %}`{{ variable_name }}`{% endraw %} will act as per normal.
Meaning, the user would still be able to use variables in your special tags!
Like static include, pages within the site should be able to use files located in folders within boilerplate.
-Also, the boilerplate file name (e.g. inside.md) and the file that it is supposed to act as (notInside.md) can be different.
This file should behaves as if it is in the requirements folder:
Also, the boilerplate file name (e.g. inside.md) and the file that it is supposed to act as (notInside.md) can be different.
This file should behaves as if it is in the requirements folder:
Tested with the folllowing include
@@ -347,7 +347,7 @@MarkBind supports .mbd files.
MarkBind supports .mbdf files.
MarkBind supports .mbdf files.
Include from another Markbind site
Test nunjucks raw tags
+ +{{ code elements should automatically be assigned v-pre }}
+
User stories are brief (typically, 1-3 sentences) descriptions of what the system can do for the users, written in the customers’ language. Often, user stories are written by the customers themselves.
A commonly used format for writing user stories is:
- As a <use type/role> I can <function> so that <benefit>
As a <use type/role> I can <function> so that <benefit>
Here are some examples of user stories for the IVLE system:
-* As a student, I can download files uploaded by lecturers, so that I can get my own copy of the files.
* As a lecturer, I can create discussion forums, so that students can discuss things online.
* As a tutor, I can print attendance sheets, so that I can take attendance during the class.
-The <benefit> can be omitted if it is obvious. E.g. As a tutor, I can print attendance sheets.
+
* As a student, I can download files uploaded by lecturers, so that I can get my own copy of the files.
* As a lecturer, I can create discussion forums, so that students can discuss things online.
* As a tutor, I can print attendance sheets, so that I can take attendance during the class.
+The <benefit> can be omitted if it is obvious. E.g. As a tutor, I can print attendance sheets.
User stories are mainly used for early estimation and scheduling purposes.
According to this, the biggest difference between user stories and traditional requirements
specifications is in the level of detail. User stories should only provide enough detail to make a reasonably low risk
diff --git a/test/functional/test_site/expected/testCodeBlocks.html b/test/functional/test_site/expected/testCodeBlocks.html
index a6bf1326da..ab7d3f1c49 100644
--- a/test/functional/test_site/expected/testCodeBlocks.html
+++ b/test/functional/test_site/expected/testCodeBlocks.html
@@ -28,39 +28,39 @@
Test: Code blocks Normal fenced code should render correctly With syntax coloring should render correctly Should render correctly with heading Inline markdown contained in heading should also be rendered correctly Code block with multiple linebreaks should not have the empty lines collapsed Code block without line numbers and multiple linebreaks should not have the empty lines collapsed Code block with syntax highlighting and multiple linebreaks should not have the empty lines collapsed span with span with tooltip, test trigger, test Question hint and answer should have algolia-no-index class There should be no text between this and the next There should be no text between this and the next There should be no text between this and the next There should be no text between this and the next There should be text between this and the next There should be text between this and the next This has the same content has the previous test, but it is not a special tag.
- The html comment There are two self closing special tags below, which should display nothing, but are present in the output.
- There is then one special tag with both and opening and closing tag with some text in it ( This should pass the htmlparser2 patch but not the markdown-it patch as it violates commonmark. A A ❗️ some important explanationtooltip, a modal, a link, a badge, another badge.
+ Content in a fenced code blockContent in a fenced code block
- <foo>
<bar type="name">goo</bar>
</foo>no-line-numbers attr should hide corresponding line numbers
- <foo>
<bar type="name">goo</bar>
</foo>start-from attr should set inline css in <code> tag, enabling lines to start from a specific line number
- *****
-----highlight-lines attr causes corresponding lines to have 'highlighted' class
- 1 highlighted
2
3 highlighted
4
5 highlighted
6 highlighted
7 highlighted
8 highlighted
9
10highlight-lines attr with start-from attr should cause corresponding lines to have 'highlighted' class based on start-from
+ 11 highlighted
12
13 highlighted
14
15 highlighted
16 highlighted
17 highlighted
18 highlighted
19
20
+ <foo>
<bar type="name">goo</bar>
</foo>no-line-numbers attr should hide corresponding line numbers
+ <foo>
<bar type="name">goo</bar>
</foo>start-from attr should set inline css in <code> tag, enabling lines to start from a specific line number
+ *****
-----highlight-lines attr causes corresponding lines to have 'highlighted' class
+ 1 highlighted
2
3 highlighted
4
5 highlighted
6 highlighted
7 highlighted
8 highlighted
9
10highlight-lines attr with start-from attr should cause corresponding lines to have 'highlighted' class based on start-from11 highlighted
12
13 highlighted
14
15 highlighted
16 highlighted
17 highlighted
18 highlighted
19
20
+ <foo>
<bar>
</foo><foo>
<bar>
</foo>Strike through, Super Bold, Underline, Highlight, 👍 ❗️ ❌ 🚧
We support page breaks
+ <foo>
<bar>
</foo><foo>
<bar>
</foo>
+
Four empty lines below, one above
Four empty lines above, one below
Four empty lines below, one above
Four empty lines above, one below
+
Four empty lines below, one above
Four empty lines above, one below
Four empty lines below, one above
Four empty lines above, one below
-
function fourEmptyLinesBelowOneAbove() {
} // four empty lines above, one belowhljs class should span multiple lines (Link for context)
+ *****
-----
+
function fourEmptyLinesBelowOneAbove() {
} // four empty lines above, one belowhljs class should span multiple lines (Link for context)*****
-----
-
+ border='3px solid red'border='3px solid red'3 pixel thick solid red line
diff --git a/test/functional/test_site/expected/testTooltipSpacing.html b/test/functional/test_site/expected/testTooltipSpacing.html
index ba0a6961cb..75220e49e3 100644
--- a/test/functional/test_site/expected/testTooltipSpacing.html
+++ b/test/functional/test_site/expected/testTooltipSpacing.html
@@ -27,7 +27,7 @@
-
+ 4px dotted blue4px dotted blue4 pixel thick dotted blue line
569: Stray space after tooltip
-
+ <tooltip>tooltip</tooltip>, test
<trigger>trigger</trigger>, test<tooltip>tooltip</tooltip>, test
<trigger>trigger</trigger>, test{{ code elements should automatically be assigned v-pre }}
+
+{% endraw %}
diff --git a/test/functional/test_site_algolia_plugin/expected/index.html b/test/functional/test_site_algolia_plugin/expected/index.html
index 65e66db8ef..5d2bb6b508 100644
--- a/test/functional/test_site_algolia_plugin/expected/index.html
+++ b/test/functional/test_site_algolia_plugin/expected/index.html
@@ -60,7 +60,7 @@
algolia-no-index class
+ TitleContent as attribute does not require algolia-no-index class
Functional test for htmlparser2 and markdown-it patches for special tags
So far as to comply with the commonmark spec
- <hr> tag in the browser, since it is a <script> tag.
+ <hr> tag in the browser, since it is a <script> tag.
There should be an alert with the value of 2 as well.
- <hr> tag in the browser, since it is a <style> tag.<hr> tag in the browser, since it is a <style> tag.
- <hr> tag, since it is a special tag.
+ <hr> tag, since it is a special tag.
All text should appear in the browser window as a single line,
save for the comment which the browser still interprets. (but will be in the expected output)So far as to comply with t
success!
<!-- --> should disappear in the expected output.
- The line some text should appear as per normal, and not wrapped by a paragraph since
+ The html comment <!-- --> should disappear in the expected output.
+ The line some text should appear as per normal, and not wrapped by a paragraph since
a html tag precedes it without a blank line.
The other lines should be parsed as markdown paragraphs, as per commonmark spec.So far as to comply with t
lorem ipsum...).
+ There is then one special tag with both and opening and closing tag with some text in it (lorem ipsum...).
Note that script and style tags are still not allowed to be self-closing, as per the html5 spec.So far as to comply with t
- All lines after the first !success wrapping text will be wrapped in a <p>...</p> tag as it is
+ All lines after the first !success wrapping text will be wrapped in a <p>...</p> tag as it is
parsed as a markdown paragraph.Heading 1<foo>
<bar type="name">goo</bar>
</foo>
+ code example:<foo>
<bar type="name">goo</bar>
</foo>Sub Heading 1.1