IT'S A SECRET TO EVERYBODY.
+Stay awhile, and listen!
+Test
+ + +``` + +#### Inline Code block + +If we want, we can also `specify inline code` which is useful for `the small stuff`. + +## List Types + +#### Ordered List + +1. First item +2. Second item +3. Third item + +#### Unordered List + +- List item +- Another item +- And another item + +#### Nested list + +- Fruit + - Apple + - Orange + - Banana +- Dairy + - Milk + - Cheese + +## Other Elements — abbr, sub, sup, kbd, mark, link + +GIF is a bitmap image format. + +H2O + +Xn + Yn = Zn + +Press CTRL+ALT+Delete to end the +session. + +Most salamanders are nocturnal, and hunt for insects, worms, and +other small creatures. + +--- + +[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) +during Gopherfest, November 18, 2015. + +[^2]: The quote is the first sentence of Aristotle's [Metaphysics](https://en.wikipedia.org/wiki/Metaphysics_(Aristotle)). diff --git a/content/overview-math.md b/content/overview-math.md new file mode 100644 index 0000000..df1b8b4 --- /dev/null +++ b/content/overview-math.md @@ -0,0 +1,91 @@ ++++ +title = "Mathematical Notations Support" +date = 2021-05-05 +updated = 2022-01-01 +[taxonomies] +categories = ["Features"] +tags = ["KaTeX", "Mathematics"] +[extra] +math = true ++++ + +You can use [$\KaTeX$](https://katex.org) to render mathematical notations. + +You can enable the $\KaTeX$ support globally, per-section or per-page basis. + +### Enable Globally + +To enable the $\KaTeX$ support globally, add `math = true` under `[extra]` of the `config.toml` +at your site root. Now every section and page of your site will load the KaTeX [autorender extension](https://katex.org/docs/autorender.html). + +```toml +[extra] +math = true +``` + +### Per-section Basis + +To enable the $\KaTeX$ support in a particular section, add `math = true` under `[extra]` in the `[SECTION_NAME]/_index.md`. Now every page under this section will load the KaTeX +[autorender extension](https://katex.org/docs/autorender.html). + +```md ++++ +[extra] +math = true ++++ +``` + +### Per-page Basis + +To enable the $\KaTeX$ support in a particular page, add `math = true` under `[extra]` in the page's +frontmatter. Now this page will load the $\KaTeX$ [autorender extension](https://katex.org/docs/autorender.html). + +```markdown ++++ +[extra] +math = true ++++ +``` + +It is a good practice to enable $\KaTeX$ support on a per-page basis, since this will only load the +required files on that particular page, without affecting the page load speed of other pages. +If your site is not math-heavy, please do NOT enable this feature globally or per-section basis. + +## Usage + +Wrap any [valid](https://katex.org/docs/supported.html) $\KaTeX$ syntax with `$...$` for inline +Mathematics and `$$...$$` for block Mathematics. + +### Inline Mathematics + +This is the most beautiful equation I've ever seen: + +``` +$e^{i\pi}+1=0$ +``` +$e^{i\pi}+1=0$ + +### Block Mathematics + +Some Mathematics in display mode is fair enough: + +``` +$$ +\int_0^1 x^2 dx +$$ +``` +$$ +\int_0^1 x^2 dx +$$ + +### Another Example + +``` +$$ +f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi +$$ +``` + +$$ +f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi +$$ diff --git a/content/overview-rich-content.md b/content/overview-rich-content.md new file mode 100644 index 0000000..b511713 --- /dev/null +++ b/content/overview-rich-content.md @@ -0,0 +1,90 @@ ++++ +title = "Rich Content" +description = "A brief description of Zola Shortcodes" +date = 2021-05-06 + +[taxonomies] +categories = ["Features"] +tags = ["video", "audio", "images", "shortcodes"] +[extra] +toc = true ++++ + +Several custom shortcodes are included to augment CommonMark (courtesy of d3c3nt theme), in addition to those [already provided by Zola][built-in]. `video`, `image`, `gif`, and `audio` were created to help you take advantage of modern HTML elements in your writing. + + + +## Video + +The `video` shortcode takes a `sources` parameter (an array of strings) +and returns a `