diff options
| author | Jieiku | 2022-03-27 19:19:28 -0700 |
|---|---|---|
| committer | Jieiku | 2022-03-27 19:19:28 -0700 |
| commit | 2ef7c0ec1ff976b807691fea23eaaf5ea1e93bc9 (patch) | |
| tree | 33dda7250a49739153f501dbdec7c26792d87964 /content | |
| download | abridge-2ef7c0ec1ff976b807691fea23eaaf5ea1e93bc9.tar.gz abridge-2ef7c0ec1ff976b807691fea23eaaf5ea1e93bc9.tar.bz2 abridge-2ef7c0ec1ff976b807691fea23eaaf5ea1e93bc9.zip | |
init
Diffstat (limited to 'content')
| -rw-r--r-- | content/_index.md | 4 | ||||
| -rw-r--r-- | content/overview-abridge.md | 23 | ||||
| -rw-r--r-- | content/overview-embedded-videos.md | 23 | ||||
| -rw-r--r-- | content/overview-images/image.jpg | bin | 0 -> 123922 bytes | |||
| -rw-r--r-- | content/overview-images/index.md | 26 | ||||
| -rw-r--r-- | content/overview-images/rust.png | bin | 0 -> 14303 bytes | |||
| -rw-r--r-- | content/overview-markdown-syntax.md | 161 | ||||
| -rw-r--r-- | content/overview-math.md | 91 | ||||
| -rw-r--r-- | content/overview-rich-content.md | 90 | ||||
| -rw-r--r-- | content/pages/_index.md | 3 | ||||
| -rw-r--r-- | content/pages/about.md | 20 | ||||
| -rw-r--r-- | content/pages/contact.md | 5 | ||||
| -rw-r--r-- | content/pages/privacy.md | 11 | ||||
| -rw-r--r-- | content/posts/_index.md | 4 |
14 files changed, 461 insertions, 0 deletions
diff --git a/content/_index.md b/content/_index.md new file mode 100644 index 0000000..3511f76 --- /dev/null +++ b/content/_index.md @@ -0,0 +1,4 @@ ++++ +paginate_by = 3 +sort_by = "date" ++++ diff --git a/content/overview-abridge.md b/content/overview-abridge.md new file mode 100644 index 0000000..51beea6 --- /dev/null +++ b/content/overview-abridge.md @@ -0,0 +1,23 @@ ++++ +title = "Abridge Zola theme and css framework" +date = 2021-05-10 + +[taxonomies] +categories = ["Features"] +tags = ["theme","config"] ++++ + +For quick setup copy the config.toml from the abridge theme into the root of your zola site, this will give you a base configuration with all config values used. +<!-- more --> +You can then edit or comment out the values in this file as necessary. + +You should also uncomment out the line #theme = "abridge" in your root zola config.toml file. This tells your root zola site to use the abridge theme in the themes folder. + +You can set the number of items that appear on the home page by editing `themes\abridge\content\_index.md` file and adjusting `paginate_by = 5` + +You can set the overal page width by editing `themes\abridge\sass\_variables.scss` file, and adjusting these two lines: + +```scss +$mw:50% !default;// max-width +$mb:1200px !default;// value at which to switch from fluid layout to using max-width +``` diff --git a/content/overview-embedded-videos.md b/content/overview-embedded-videos.md new file mode 100644 index 0000000..aa9074e --- /dev/null +++ b/content/overview-embedded-videos.md @@ -0,0 +1,23 @@ ++++ +title = "Embedded Youtube & Vimeo Videos" +date = 2021-05-07 + +[taxonomies] +categories = ["Features"] +tags = ["shortcodes","video"] ++++ + +Zola has many shortcodes, and new are easily added, this example shows vimeo and youtube. +<!-- more --> + +## Vimeo + +with `vm(id="id_here")` + +{{ vm(id="514402648") }} + +## Youtube + +with `yt(id="the_id_here")` + +{{ yt(id="32gyFIWecuw") }} diff --git a/content/overview-images/image.jpg b/content/overview-images/image.jpg Binary files differnew file mode 100644 index 0000000..7b9e98d --- /dev/null +++ b/content/overview-images/image.jpg diff --git a/content/overview-images/index.md b/content/overview-images/index.md new file mode 100644 index 0000000..0e623e5 --- /dev/null +++ b/content/overview-images/index.md @@ -0,0 +1,26 @@ ++++ +title = "Images, Direct and Relative Path" +date = 2021-05-08 + +[taxonomies] +categories = ["Features"] +tags = ["images"] ++++ + +Images can be embed using direct or relative paths. +<!-- more --> +Use `img()` to specify the relative path of image: + +{{ img(path="./image.jpg", alt="") }} + +This is an example note with direct image, without using shortcode: + + + +This is an svg image: + +<svg class="canon" xmlns="http://www.w3.org/2000/svg" overflow="visible" viewBox="0 0 496 373" height="373" width="496"><g fill="none"><path stroke="#000" stroke-width=".75" d="M.599 372.348L495.263 1.206M.312.633l494.95 370.853M.312 372.633L247.643.92M248.502.92l246.76 370.566M330.828 123.869V1.134M330.396 1.134L165.104 124.515"></path><path stroke="#ED1C24" stroke-width=".75" d="M275.73 41.616h166.224v249.05H275.73zM54.478 41.616h166.225v249.052H54.478z"></path><path stroke="#000" stroke-width=".75" d="M.479.375h495v372h-495zM247.979.875v372"></path><ellipse cx="498.729" cy="177.625" rx=".75" ry="1.25"></ellipse><ellipse cx="247.229" cy="377.375" rx=".75" ry="1.25"></ellipse></g></svg> + +<style> +.canon { background: white; width: 50%; height: auto; } +</style> diff --git a/content/overview-images/rust.png b/content/overview-images/rust.png Binary files differnew file mode 100644 index 0000000..38cbc4f --- /dev/null +++ b/content/overview-images/rust.png diff --git a/content/overview-markdown-syntax.md b/content/overview-markdown-syntax.md new file mode 100644 index 0000000..0a49a81 --- /dev/null +++ b/content/overview-markdown-syntax.md @@ -0,0 +1,161 @@ ++++ +title = "Markdown Syntax Guide" +description = "Sample article showcasing basic Markdown syntax and formatting for HTML elements." +date = 2021-05-09 + +[taxonomies] +categories = ["Features"] +tags = ["Markdown"] +[extra] +toc = true ++++ + +This article offers a sample of basic Markdown syntax that can be used in Zola content files, also it shows if basic HTML elements are decorated with CSS in a Zola theme. +<!-- more --> +## Headings + +The following HTML `<h1>`—`<h6>` elements represent six levels of section +headings. `<h1>` is the highest section level while `<h6>` is the lowest. + +# H1 +## H2 +### H3 +#### H4 +##### H5 +###### H6 + +## Paragraph + +Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, +voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma +dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as +cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin +porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? +Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit +ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda +veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore +eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata +tiustia prat. + +Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne +sapicia is sinveli squiatum, core et que aut hariosam ex eat. + +## Blockquotes + +The blockquote element represents content that is quoted from another source, +optionally with a citation which must be within a `footer` or `cite` element, +and optionally with in-line changes such as annotations and abbreviations. + +#### Blockquote without attribution + +> Tiam, ad mint andaepu dandae nostion secatur sequo quae. +> **Note** that you can use *Markdown syntax* within a blockquote. + +#### Blockquote with attribution + +> Don't communicate by sharing memory, share memory by communicating.<br> +> — <cite>Rob Pike[^1]</cite> + +> All men by nature desire to know.<br> +> ― <cite>Aristotle[^2]</cite> + +## Tables + +Tables aren't part of the core Markdown spec, but Zola supports them +out-of-the-box. + + Name | Age +--------|------ + Alice | 23 + Bob | 27 + Cody | 33 + John | 59 + Kerry | 23 + +#### Inline Markdown within tables + +| Italics | Bold | Code | StrikeThrough | +| -------- | -------- | ------ | ----------------- | +| *italics* | **bold** | `code` | ~~strikethrough~~ | + +## Foldable Text + +<details> + <summary>Title 1</summary> + <p>IT'S A SECRET TO EVERYBODY.</p> +</details> + +<details> + <summary>Title 2</summary> + <p>Stay awhile, and listen!</p> +</details> + +## Code Blocks + +Code blocks.. ❤️ with automatic syntax highlighting ✨ + +See [the docs](https://www.getzola.org/documentation/content/syntax-highlighting/) for options. + +#### Code block with backticks + +```html +<!doctype html> +<html lang="en"> +<head> + <meta charset="utf-8"> + <title>Example HTML5 Document</title> +</head> +<body> + <p>Test</p> +</body> +</html> +``` + +#### 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 + +<abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format. + +H<sub>2</sub>O + +X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup> + +Press <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd></kbd> to end the +session. + +Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and +other small creatures. + +--- +<!-- Note: There must be a blank line between every two lines of the footnote difinition. --> +[^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. +<!-- more --> +### 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. + +<!-- more --> + +## Video + +The `video` shortcode takes a `sources` parameter (an array of strings) +and returns a `<video>` tag. Each string in the `sources` array should +be a path to a video file of a different type (`webm`, `mp4`, etc). Each +individual source is then converted into a `<source>` tag, and the +element is returned. + +### Usage +```rs +{{/* video(sources=["example.webm", "example.mp4"]) */}} +``` +### Output +```html +{{ video(sources=["example.webm", "example.mp4"]) }} +``` + +## Image + +The `image` shortcode returns a `<picture>` tag and accepts three +parameters: `sources` (an array of strings), `fallback_path`, and +`fallback_alt` (both strings). + +Each string in the `sources` array should be a path to an image file of +a different type (`webp`, `png`, `jpg`, etc). `fallback_path` and +`fallback_alt` are used to create an `<img>` tag for the browser to fall +back on if the other formats aren't yet supported. + +### Usage +```rs +{{/* image(sources=["example.webp", "example.jpg", "example.png"], fallback_path="example.png", fallback_alt="Lorem Ipsum") */}} +``` +### Output +```html +{{ image(sources=["example.webp", "example.jpg", "example.png"], fallback_path="example.png", fallback_alt="Lorem Ipsum") }} +``` + +## GIF + +The `gif` shortcode is exactly the same as the [video shortcode][video] +– it takes an array of strings called `sources` and returns a +`<video>` tag. The only difference is in the outermost tag, which has +four additional properties: `autoplay`, `loop`, `muted`, `playsinline`. + +Using the `<video>` tag in place of gifs allows for reduced file sizes, +which is especially important in regions where internet is slower or +less reliable. + +### Usage +```rs +{{/* gif(sources=["example.webm", "example.mp4"]) */}} +``` +### Output +```html +{{ gif(sources=["example.webm", "example.mp4"]) }} +``` + +## Audio + +The `audio` shortcode takes a `sources` array of strings and returns an +`<audio>` tag. Each string in the `sources` array should be a path to an +audio file of a different type (`wav`, `ogg`, `mp3`, etc). + +### Usage +```rs +{{/* audio(sources=["example.wav", "example.ogg", "example.mp3"]) */}} +``` +### Output +```html +{{ audio(sources=["example.wav", "example.ogg", "example.mp3"]) }} +``` + +[built-in]: https://www.getzola.org/documentation/content/shortcodes/#built-in-shortcodes +[video]: @/overview-rich-content.md#video diff --git a/content/pages/_index.md b/content/pages/_index.md new file mode 100644 index 0000000..800a244 --- /dev/null +++ b/content/pages/_index.md @@ -0,0 +1,3 @@ ++++ +render = false ++++ diff --git a/content/pages/about.md b/content/pages/about.md new file mode 100644 index 0000000..97ed9dd --- /dev/null +++ b/content/pages/about.md @@ -0,0 +1,20 @@ ++++ +title = "About" +path = "about" +template = "pages.html" ++++ + +This site provides a demo for the [abridge theme](https://github.com/Jieiku/abridge) for [Zola](https://www.getzola.org/) the static site generator. + +Abridge was created by [Jake G (jieiku)](https://github.com/Jieiku) to be fast and lightweight, using semantic html, [abridge.css](https://github.com/Jieiku/abridge-css) class-light CSS, and No JS. + +Some fun facts about the theme: + +* Perfect score on Google's Lighthouse audit +* Only ~4 KB of CSS before enabling the SVG CSS icons. +* No JavaScript +* Now with SEO! + +Nearly half of the existing Zola MIT themes were inspiration for features and design of this theme. + +Both the theme and this site are licensed under the [MIT license](https://opensource.org/licenses/MIT). diff --git a/content/pages/contact.md b/content/pages/contact.md new file mode 100644 index 0000000..10fbd30 --- /dev/null +++ b/content/pages/contact.md @@ -0,0 +1,5 @@ ++++ +title = "Contact" +path = "contact" +template = "contact.html" ++++ diff --git a/content/pages/privacy.md b/content/pages/privacy.md new file mode 100644 index 0000000..b136056 --- /dev/null +++ b/content/pages/privacy.md @@ -0,0 +1,11 @@ ++++ +title = "Privacy" +path = "privacy" +template = "pages.html" ++++ + +We do not use cookies and we do not collect any personal data. + +No personal information is collected, stored in the browser, shared, sent, or sold to third-parties. + +Effective Date: _1st Jan 2022_ diff --git a/content/posts/_index.md b/content/posts/_index.md new file mode 100644 index 0000000..e381261 --- /dev/null +++ b/content/posts/_index.md @@ -0,0 +1,4 @@ ++++ +title = "posts" +template = "posts.html" ++++ |
