-
-The requested page could not be found.
\ No newline at end of file
diff --git a/Gemfile b/Gemfile
index 7fe9f26..164b54d 100644
--- a/Gemfile
+++ b/Gemfile
@@ -7,12 +7,13 @@ source "https://rubygems.org"
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
-gem "jekyll", "~> 3.9.0"
+gem "jekyll", "~> 3.9.3"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
#gem "minima", "~> 2.5"
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
-gem "github-pages", "~> 219", group: :jekyll_plugins
+# Check supported plugins here https://pages.github.com/versions/
+gem "github-pages", "~> 228", group: :jekyll_plugins
# If you have any plugins, put them here!
group :jekyll_plugins do
#gem "jekyll-feed", "~> 0.12"
@@ -31,3 +32,5 @@ end
# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
+
+gem "webrick", "~> 1.8"
diff --git a/Gemfile.lock b/Gemfile.lock
index 0487392..fdf9e1d 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,67 +1,48 @@
GEM
remote: https://rubygems.org/
specs:
- activesupport (6.0.4.6)
+ activesupport (6.1.7.3)
concurrent-ruby (~> 1.0, >= 1.0.2)
- i18n (>= 0.7, < 2)
- minitest (~> 5.1)
- tzinfo (~> 1.1)
- zeitwerk (~> 2.2, >= 2.2.2)
- addressable (2.8.0)
- public_suffix (>= 2.0.2, < 5.0)
+ i18n (>= 1.6, < 2)
+ minitest (>= 5.1)
+ tzinfo (~> 2.0)
+ zeitwerk (~> 2.3)
+ addressable (2.8.4)
+ public_suffix (>= 2.0.2, < 6.0)
coffee-script (2.4.1)
coffee-script-source
execjs
coffee-script-source (1.11.1)
colorator (1.1.0)
- commonmarker (0.17.13)
- ruby-enum (~> 0.5)
- concurrent-ruby (1.1.9)
- dnsruby (1.61.9)
- simpleidn (~> 0.1)
+ commonmarker (0.23.9)
+ concurrent-ruby (1.2.2)
+ dnsruby (1.70.0)
+ simpleidn (~> 0.2.1)
em-websocket (0.5.3)
eventmachine (>= 0.12.9)
http_parser.rb (~> 0)
- ethon (0.15.0)
+ ethon (0.16.0)
ffi (>= 1.15.0)
eventmachine (1.2.7)
execjs (2.8.1)
- faraday (1.10.0)
- faraday-em_http (~> 1.0)
- faraday-em_synchrony (~> 1.0)
- faraday-excon (~> 1.1)
- faraday-httpclient (~> 1.0)
- faraday-multipart (~> 1.0)
- faraday-net_http (~> 1.0)
- faraday-net_http_persistent (~> 1.0)
- faraday-patron (~> 1.0)
- faraday-rack (~> 1.0)
- faraday-retry (~> 1.0)
+ faraday (2.7.7)
+ faraday-net_http (>= 2.0, < 3.1)
ruby2_keywords (>= 0.0.4)
- faraday-em_http (1.0.0)
- faraday-em_synchrony (1.0.0)
- faraday-excon (1.1.0)
- faraday-httpclient (1.0.1)
- faraday-multipart (1.0.3)
- multipart-post (>= 1.2, < 3)
- faraday-net_http (1.0.1)
- faraday-net_http_persistent (1.2.0)
- faraday-patron (1.0.0)
- faraday-rack (1.0.0)
- faraday-retry (1.0.3)
+ faraday-net_http (3.0.2)
ffi (1.15.5)
forwardable-extended (2.6.0)
gemoji (3.0.1)
- github-pages (219)
- github-pages-health-check (= 1.17.7)
- jekyll (= 3.9.0)
+ github-pages (228)
+ github-pages-health-check (= 1.17.9)
+ jekyll (= 3.9.3)
jekyll-avatar (= 0.7.0)
jekyll-coffeescript (= 1.1.1)
- jekyll-commonmark-ghpages (= 0.1.6)
+ jekyll-commonmark-ghpages (= 0.4.0)
jekyll-default-layout (= 0.1.4)
jekyll-feed (= 0.15.1)
jekyll-gist (= 1.5.0)
jekyll-github-metadata (= 2.13.0)
+ jekyll-include-cache (= 0.2.1)
jekyll-mentions (= 1.6.0)
jekyll-optional-front-matter (= 0.3.2)
jekyll-paginate (= 1.1.0)
@@ -70,7 +51,7 @@ GEM
jekyll-relative-links (= 0.6.1)
jekyll-remote-theme (= 0.4.3)
jekyll-sass-converter (= 1.5.2)
- jekyll-seo-tag (= 2.7.1)
+ jekyll-seo-tag (= 2.8.0)
jekyll-sitemap (= 1.4.0)
jekyll-swiss (= 1.0.0)
jekyll-theme-architect (= 0.2.0)
@@ -88,31 +69,31 @@ GEM
jekyll-theme-time-machine (= 0.2.0)
jekyll-titles-from-headings (= 0.5.3)
jemoji (= 0.12.0)
- kramdown (= 2.3.1)
+ kramdown (= 2.3.2)
kramdown-parser-gfm (= 1.1.0)
- liquid (= 4.0.3)
+ liquid (= 4.0.4)
mercenary (~> 0.3)
minima (= 2.5.1)
- nokogiri (>= 1.10.4, < 2.0)
+ nokogiri (>= 1.13.6, < 2.0)
rouge (= 3.26.0)
terminal-table (~> 1.4)
- github-pages-health-check (1.17.7)
+ github-pages-health-check (1.17.9)
addressable (~> 2.3)
dnsruby (~> 1.60)
octokit (~> 4.0)
public_suffix (>= 3.0, < 5.0)
typhoeus (~> 1.3)
- html-pipeline (2.14.0)
+ html-pipeline (2.14.3)
activesupport (>= 2)
nokogiri (>= 1.4)
http_parser.rb (0.8.0)
- i18n (0.9.5)
+ i18n (1.14.1)
concurrent-ruby (~> 1.0)
- jekyll (3.9.0)
+ jekyll (3.9.3)
addressable (~> 2.4)
colorator (~> 1.0)
em-websocket (~> 0.5)
- i18n (~> 0.7)
+ i18n (>= 0.7, < 2)
jekyll-sass-converter (~> 1.0)
jekyll-watch (~> 2.0)
kramdown (>= 1.17, < 3)
@@ -126,13 +107,13 @@ GEM
jekyll-coffeescript (1.1.1)
coffee-script (~> 2.2)
coffee-script-source (~> 1.11.1)
- jekyll-commonmark (1.3.1)
- commonmarker (~> 0.14)
- jekyll (>= 3.7, < 5.0)
- jekyll-commonmark-ghpages (0.1.6)
- commonmarker (~> 0.17.6)
- jekyll-commonmark (~> 1.2)
- rouge (>= 2.0, < 4.0)
+ jekyll-commonmark (1.4.0)
+ commonmarker (~> 0.22)
+ jekyll-commonmark-ghpages (0.4.0)
+ commonmarker (~> 0.23.7)
+ jekyll (~> 3.9.0)
+ jekyll-commonmark (~> 1.4.0)
+ rouge (>= 2.0, < 5.0)
jekyll-default-layout (0.1.4)
jekyll (~> 3.0)
jekyll-feed (0.15.1)
@@ -163,7 +144,7 @@ GEM
rubyzip (>= 1.3.0, < 3.0)
jekyll-sass-converter (1.5.2)
sass (~> 3.4)
- jekyll-seo-tag (2.7.1)
+ jekyll-seo-tag (2.8.0)
jekyll (>= 3.8, < 5.0)
jekyll-sitemap (1.4.0)
jekyll (>= 3.7, < 5.0)
@@ -216,12 +197,12 @@ GEM
gemoji (~> 3.0)
html-pipeline (~> 2.2)
jekyll (>= 3.0, < 5.0)
- kramdown (2.3.1)
+ kramdown (2.3.2)
rexml
kramdown-parser-gfm (1.1.0)
kramdown (~> 2.0)
- liquid (4.0.3)
- listen (3.7.1)
+ liquid (4.0.4)
+ listen (3.8.0)
rb-fsevent (~> 0.10, >= 0.10.3)
rb-inotify (~> 0.9, >= 0.9.10)
mercenary (0.3.6)
@@ -229,30 +210,23 @@ GEM
jekyll (>= 3.5, < 5.0)
jekyll-feed (~> 0.9)
jekyll-seo-tag (~> 2.1)
- minitest (5.15.0)
- multipart-post (2.1.1)
- nokogiri (1.13.6-arm64-darwin)
+ minitest (5.18.1)
+ nokogiri (1.13.10-arm64-darwin)
racc (~> 1.4)
- nokogiri (1.13.6-x64-unknown)
+ nokogiri (1.13.10-x86_64-darwin)
racc (~> 1.4)
- nokogiri (1.13.6-x86_64-darwin)
- racc (~> 1.4)
- nokogiri (1.13.6-x86_64-linux)
- racc (~> 1.4)
- octokit (4.22.0)
- faraday (>= 0.9)
- sawyer (~> 0.8.0, >= 0.5.3)
+ octokit (4.25.1)
+ faraday (>= 1, < 3)
+ sawyer (~> 0.9)
pathutil (0.16.2)
forwardable-extended (~> 2.6)
- public_suffix (4.0.6)
- racc (1.6.0)
- rb-fsevent (0.11.1)
+ public_suffix (4.0.7)
+ racc (1.7.1)
+ rb-fsevent (0.11.2)
rb-inotify (0.10.1)
ffi (~> 1.0)
rexml (3.2.5)
rouge (3.26.0)
- ruby-enum (0.9.0)
- i18n
ruby2_keywords (0.0.5)
rubyzip (2.3.2)
safe_yaml (1.0.5)
@@ -261,40 +235,38 @@ GEM
sass-listen (4.0.0)
rb-fsevent (~> 0.9, >= 0.9.4)
rb-inotify (~> 0.9, >= 0.9.7)
- sawyer (0.8.2)
+ sawyer (0.9.2)
addressable (>= 2.3.5)
- faraday (> 0.8, < 2.0)
+ faraday (>= 0.17.3, < 3)
simpleidn (0.2.1)
unf (~> 0.1.4)
terminal-table (1.8.0)
unicode-display_width (~> 1.1, >= 1.1.1)
- thread_safe (0.3.6)
typhoeus (1.4.0)
ethon (>= 0.9.0)
- tzinfo (1.2.10)
- thread_safe (~> 0.1)
+ tzinfo (2.0.6)
+ concurrent-ruby (~> 1.0)
unf (0.1.4)
unf_ext
- unf_ext (0.0.8)
+ unf_ext (0.0.8.2)
unicode-display_width (1.8.0)
- zeitwerk (2.5.4)
+ webrick (1.8.1)
+ zeitwerk (2.6.8)
PLATFORMS
- universal-darwin-20
- universal-darwin-21
+ arm64-darwin-23
universal-darwin-22
- x64-unknown
- x86_64-linux
DEPENDENCIES
- github-pages (~> 219)
- jekyll (~> 3.9.0)
+ github-pages (~> 228)
+ jekyll (~> 3.9.3)
jekyll-include-cache
jekyll-relative-links
jekyll-sitemap
tzinfo (~> 1.2)
tzinfo-data
wdm (~> 0.1.1)
+ webrick (~> 1.8)
BUNDLED WITH
- 2.2.31
+ 2.4.15
diff --git a/README.md b/README.md
index 6353ea8..b9bb1dc 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,629 @@
-# SQLBI Documentation
+# Welcome to Docs0
-Browse the documentation at [docs.sqlbi.com](https://docs.sqlbi.com)
\ No newline at end of file
+Docs0 is a Markdown-based documentation website than runs on GitHub Pages. It is based on the Jekyll static site generator. In this page you will find all the information you need to customize the website.
+
+You must follow only 3 steps:
+- Configure the website by changing the parameters in the `_config.yml` file.
+- Update the content of `_myassets` folder (images, css).
+- Add your documents to the `_mydocs` folder (md, see sections below).
+
+
+## Test Locally
+
+You can run the website locally to see the changes before pushing them to the repository. To do this, you need to install Jekyll and the GitHub Pages gem.
+See: [Setting up your GitHub Pages site locally with Jekyll](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll)
+
+
+## Directory Structure
+
+User content is placed in folders starting with `_my` prefix (e.g. `_mydocs`, `_myassets`), this way it is easier to understand what is part of the website structure and what is not.
+
+Documentation content is placed in the `_mydocs` folder. The folder structure is used to create the navigation menu of the website.
+Each document is a Markdown file with a ***.md*** extension.
+
+Folders, files and images must be named using the following rules:
+
+- **Don't put spaces** or other special characters ***(_ & , ; : % $ " ' / \\ ? ! @)*** in file names.
+For example: ***this-is-a-new-file.md*** instead of ***this is a new_file.md***.
+- **Use lowercase** file names.
+For example: ***dropdown1.png*** instead of ***Dropdown1.png***.
+
+> Note that folders and files starting with an underscore (***_***) are ignored by the system, so if you need to create some internal files, please use this prefix or (better) place them in a folder starting with `_my` (e.g. `_myinternal`).
+
+
+## Editing Conventions (and Markdown Syntax)
+
+Markdown documents are simple text files with additional special syntax that you can use to style your content, embed images, or create links.
+
+These documents are interpreted, this means that **what you write is not exactly what will appear** on the website, for this reason, it is recommended to use the VSCode preview pane to see the final result while editing.
+
+> **NOTE:** Don't use any Markdown flavor, just standard Markdown syntax.
+
+Jump to:
+- [Header](#header)
+- [Body](#body)
+- [Title](#title)
+- [Paragraph](#paragraph)
+- [Carriage Return](#carriage-return)
+- [Bold](#bold)
+- [Italic](#italic)
+- [Bold Italic](#bold-italic)
+- [Unordered List](#unordered-list)
+- [Ordered List](#ordered-list)
+- [Table](#table)
+- [Notice](#notice)
+- [Code](#code)
+- [Line](#line)
+- [Link](#link)
+- [Screenshot (Image)](#screenshot-image)
+- [Screencast (Video)](#screencast-video)
+- [Badges](#badges)
+- [Color Cells](#color-cells)
+- [Next Reading](#next-reading)
+- [TODOs](#todos)
+- [Comments](#comments)
+
+
+### Header
+
+Every file must contain a header (Front Matter) in the following format (note that the ***\-\-\-*** lines are required):
+
+ ---
+ layout: page
+ title: Document title
+ description: Document description in HTML meta/Next Reading/Related
+ menu_title: Document title in menu
+ next_title: Document title in Next Reading section
+ published: true
+ draft: false
+ date: 2021-11-15
+ modified: 2022-07-20
+ order: /01/02/document-title
+ toc: true
+ toc_h_min: (site setting - default 2)
+ toc_h_max: (site setting - default 3)
+ breadcrumbs: true
+ version: 2.0
+ available: Availability note
+ premium: /01/premium.md
+ internal: Internal reference (not displayed)
+ next_reading: false
+ next_reading_title: Next Reading
+ next_reading_ol: false
+ related:
+ - page-1.md
+ - page-2.md,
+ - /folder/page-3.md
+ related_title: Related Pages
+ ---
+
+Parameters:
+
+- **layout:** always set the value ***page***.
+- **title:** set the title of the document.
+- **description:** (optional) a page description used in page meta and the ***Next Reading***/***Related*** sections
+- **menu_title:** (optional) set a title for the navigation menu, if you want to make it different from the main title.
+- **next_title:** (optional) set a title for the ***Next Reading*** section of the pages, if you want to make it different from the main title.
+- **published:** set ***true*** to display the document on the website
+- **draft:** (optional) set ***true*** to show a notice that the document is not completed (note that this notice appears automatically if the document is empty or if it contains a <todo></todo> tag. Set ***nodraft: true*** to avoid displaying the notice.
+- **date:** set the creation date of the document.
+- **modified:** set the date of the last modification of the document.
+- **order:** set a string to be used to sort the document in the navigation menu - check existing files to know how sorting works. In general, if the page is the child of a node, it is necessary to insert the order attribute of the parent node plus a slash ***/*** and a number (if you want to give a static position) or a sanitized version of the title (without spaces and special characters - if you want to use alphabetical sorting). Note that numbers come before letters (as they are placed before in the ASCII table); if you want that they are placed after letters, you need to enclose them in curly braces: e.g. ***zzz*** is after ***01*** but before ***{01}***.
+- **toc:** (optional) set ***false*** to hide the automatic table of contents.
+- **toc_h_min:** (optional) set the minimum heading level to include in the table of contents. This setting is set at the site level in the `_config.yml`. Default is 2.
+- **toc_h_max:** (optional) set the maximum heading level to include in the table of contents. This setting is set at the site level in the `_config.yml`. Default is 3.
+- **breadcrumbs:** (optional) set ***false*** to hide the breadcrumb.
+- **internal:** (optional) used to define some internal reference, useful for maintenance - not displayed on the website.
+- **next_reading:** (optional) set **true** to show the ***Next Reading*** section at the end of the page. Note there is also a [special template tag](#next-reading) you can use to obtain the same result, useful if you need to place it on a different position.
+- **next_reading_title:** (optional) set a custom title for the ***Next Reading*** section. Default is: "Next Reading". It can be **false** to deactivate title. You can change the title at the site level by editing the **next_reading_title** variable in the `_config.yml` file.
+- **next_reading_ol:** (optional) list items as ordered list.
+- **related:** (optional) define a list of pages related to this one; you can use URLs relative to the _user_docs root (they must start with a slash) or relative to the same parent path (no slashes at the beginnig) - **../** is not supported. At the bottom of the page will be displayed a section like ***Next Reading***. If defined, the **next_reading** option will be ignored.
+- **related_title:** (optional) set a custom title for the related section. Default is: "Related Pages". You can change the title at the site level by editing the **related_title** variable in the `_config.yml` file.
+
+### Body
+
+Here is a common list of elements you may want to use in your documents. For the full syntax, check out this [external guide](https://www.markdownguide.org/basic-syntax/)
+
+#### Title
+
+Use titles to separate sections of the document. The table of content is automatically created using the structure you define with titles.
+
+> Note that **Title 1** is used as the main title of the document - don't use it.
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
## Title 2
+
+
+
Title 2
+
+
+
+
+
### Title 3
+
+
+
Title 3
+
+
+
+
+
#### Title 4
+
+
+
Title 4
+
+
+
+
+
##### Title 5
+
+
+
Title 5
+
+
+
+
+
###### Title 6
+
+
+
Title 6
+
+
+
+
+
+#### Paragraph
+
+Define paragraphs by inserting a blank line between them.
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
This line is in paragraph 1.
+
+This line is in paragraph 2.
+
+
+
This line is in paragraph 1.
+
This line is in paragraph 2.
+
+
+
+
+#### Carriage Return
+
+Put at least two spaces after the end of a line and a carriage return, otherwise the carriage return alone will be ignored.
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
This line is in line 1. (two spaces here)
+This line is in line 2.
+
+
+ This line is in line 1.
+ This line is in line 2.
+
+
+
+
+#### Bold
+
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
This text is **bold**.
+
+
+ This text is bold.
+
+
+
+
+#### Italic
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
This text is *italic*.
+
+
+ This text is italic.
+
+
+
+
+#### Bold Italic
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
This text is ***bold italic***.
+
+
+ This text is bold italic.
+
+
+
+
+
+#### Unordered List
+
+
+
Markdown
+
Rendered Output
+
+
+
+
+- Item A
+- Item B
+- Item C
+
+
+
+
+
Item A
+
Item B
+
Item C
+
+
+
+
+
+#### Ordered List
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
+1. Item 1
+2. Item 2
+3. Item 3
+
+
+
+
+
Item 1
+
Item 2
+
Item 3
+
+
+
+
+
+#### Table
+
+
+
+
Markdown
+
Rendered Output
+
+
+
+
+| Column A | Column B |
+| --- | --- |
+| Value 1A | Value 1B |
+| Value 2A | Value 2B |
+
+
+The URL of the links can be:
+
+- **Absolute URL**
+ When you need to link a page external to the repo. For instance:
+
+ `[OKVIZ website](https://okviz.com/)`
+
+- **Relative URL**
+ When you need to link a page of the repo.
+
+ - If the page to link is in the same folder as the document, simply use the file name as the URL.
+ For example, ***smart-filter-pro/changelog.md*** contains the following link to ***smart-filter-pro/about.md***:
+
+ `[About](about.md)`
+
+ - If the page belongs to a different folder, you need to go up one level and include the new folder name in the URL.
+ For example, ***smart-filter-pro/changelog.md*** contains the following link to ***general/licensing.md***:
+
+ `[Licensing](../general/licensing.md)`
+
+- **Anchor**
+ Markdown automatically generates anchors for each title/heading you place in a document.
+ An anchor is a way to identify a location in a document.
+ Every anchor has an ID equal to a sanitized version of the title it refers to.
+ For example, a title like this:
+
+ `## Check for updates`
+
+ has an anchor with this ID:
+
+ `check-for-updates`
+
+ Sanitizing the title means that spaces are replaced with dashes ***-*** and all special characters (such as & , ; :) are removed.
+
+ You can create links to anchors by adding a # plus the anchor ID to the URL.
+ For example, ***smart-filter-pro/changelog.md*** contains this link to the Price section of ***general/licensing.md***:
+
+ `[Licensing](../general/licensing.md#price)`
+
+ If the link needs to point to an anchor on the same document, you can simply write # plus the anchor ID.
+ For instance:
+
+ `[See "Check for updates" below](#check-for-updates)`
+
+#### Screenshot (Image)
+
+
+
+
Syntax
+
Rendered Output
+
+
+
+
<img src="images/screenshot.png" width="500">
+
+
+ N/A
+
+
+
+
+You are not allowed to embed images in Markdown documents like in Word, but they must be referenced from another location. This means that you need to place image files in a separate folder to use them in a document.
+
+Always create a folder called images in the parent folder of the document you are working on (if it doesn't exist) and put all the images in it. For example, the images of ***smart-filter-pro/about.md*** must be placed in the folder ***_user_docs/smart-filter-pro/images/***.
+
+> Set a reasonable number of pixels in the ***width*** attribute of the <img> tag.
+
+> You can align text around images by adding `class="fr"` or `class="fl"` to the img tag.
+
+> You can remove borders from images by adding `class="noborder"` to the img tag.
+
+#### Screencast (Video)
+
+
+
+Like with images, you need to use a HTML syntax to embed videos in your pages. Follow the same rules and best practices of images.
+
+> Be sure to include ***autoplay***, ***loop*** and ***muted*** attributes.
+
+#### Badges
+
+Sometimes it is necessary to display the availability limits of a feature described by the document. You can do this by adding the ***available***, ***version*** or ***premium*** attributes in the [document header](#header) or, if you need to put this information in a different position on the page, you can use this syntax anywhere in the text:
+
+
+
+
Syntax
+
Rendered Output
+
+
+
+
{% include badge in="Mode A" %}
+
+
+
Mode A
+
+
+
+
+
{% include badge v="1.1.0" %}
+
+
+
v1.1.0
+
+
+
+
+
{% include badge premium=true %}
+
+
+
Premium ✦
+
+
+
+
+#### Color Cells
+
+You can include simple color cells in your pages.
+
+
+
+
Syntax
+
Rendered Output
+
+
+
+
{% include color value="#FF0000" %}
+
+
+
+
+
+
+
+#### Next Reading
+
+You can add a section containing a list of links to other pages at the same folder level. You can also use the ***next_reading*** option in the [document header](#header) to automatically display this section at the bottom of the page.
+
+
+
+#### TODOs
+
+You can add some placeholders and notes in unfinished documents, to keep track of the content to be edited or the tasks to be performed. **TODOs are not displayed on the website** and cause a draft notice to be displayed on the page.
+
+ Take a screenshot
+
+
+#### Comments
+
+To comments lines of text, **DO NOT USE** the standard HTML syntax ``, as it is inspectable in the browser. Instead, use the following syntax:
+
+ {% comment %}
+
+ This is a comment
+
+ {% endcomment %}
\ No newline at end of file
diff --git a/_config.yml b/_config.yml
index 8f2e147..9e7452a 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,67 +1,71 @@
-# Welcome to Jekyll!
-#
-# This config file is meant for settings that affect your whole blog, values
-# which you are expected to set up once and rarely edit after that. If you find
-# yourself editing this file very often, consider using Jekyll's data files
-# feature for the data you need to update frequently.
-#
-# For technical reasons, this file is *NOT* reloaded automatically when you use
-# 'bundle exec jekyll serve'. If you change this file, please restart the server process.
-#
-# If you need help with YAML syntax, here are some quick references for you:
-# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
-# https://learnxinyminutes.com/docs/yaml/
-#
# Site settings
-# These are used to personalize your new site. If you look in the HTML files,
-# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
-# You can create any custom variable you would like, and they will be accessible
-# in the templates via {{ site.myvariable }}.
-
-title: SQLBI Documentation
+title: SQLBI Docs
email: info@sqlbi.com
-domain: docs.sqlbi.com
-url: https://docs.sqlbi.com
company: SQLBI Corp.
-website: https://www.sqlbi.com
-github: https://github.com/sql-bi/docs
+
+# Main website URL
+web_url: https://www.sqlbi.com
+
+# Privacy URL - It's added to the website footer
+privacy_url: https://www.sqlbi.com/privacy/
+
+# GitHub URL - Leave blank if you don't want to display links to GitHub repo
+github_url:
+
+# Header quick link - This is usually a quick link to the service/product
+header_link_title:
+header_link_url:
+
+# TOC heading range
+toc_h_min: 2
+toc_h_max: 3
+toc_title: In this page
+
+# Other parameters
+next_reading_title: Next Reading
+related_title: Related Pages
+search: true
+nav_root_title: Docs
+
+
+
+### DO NOT CHANGE BELOW THIS LINE ###
+
plugins:
- jekyll-sitemap
- jekyll-relative-links
- jekyll-include-cache
+
permalink: /:categories/:title #:output_ext
+
excerpt_separator:
+
+sass:
+ style: compressed
+ sass_dir: assets/_sass
+
collections:
- docs:
- output: true
- permalink: /:path
+ pages:
+ output: true
+ permalink: /:path
+ myassets:
+ output: true
+ permalink: /assets/:path
+ mydocs:
+ output: true
+ permalink: /:path
-exclude:
- - "*.less"
relative_links:
enabled: true
collections: true
-# Build settings
-#theme: sqlbi
-#plugins:
-
-# Exclude from processing.
-# The following items will not be processed, by default.
-# Any item listed under the `exclude:` key here will be automatically added to
-# the internal "default list".
-#
-# Excluded items can be processed by explicitly listing the directories or
-# their entries' file path in the `include:` list.
-#
-# exclude:
-# - .sass-cache/
-# - .jekyll-cache/
-# - gemfiles/
-# - Gemfile
-# - Gemfile.lock
-# - node_modules/
-# - vendor/bundle/
-# - vendor/cache/
-# - vendor/gems/
-# - vendor/ruby/
+exclude:
+ - "gemfiles/"
+ - "Gemfile"
+ - "Gemfile.lock"
+ - "*.code-workspace"
+ - "README.md"
+ - ".sass-cache/"
+ - ".jekyll-cache/"
+ - "package.json"
+ - "package-lock.json"
diff --git a/_default_config.yml b/_default_config.yml
new file mode 100644
index 0000000..096ee53
--- /dev/null
+++ b/_default_config.yml
@@ -0,0 +1,71 @@
+# Site settings
+title: Docs0 Website Name
+email: info@docs0.io
+company: Docs0
+
+# Main website URL
+web_url:
+
+# Privacy URL - It's added to the website footer
+privacy_url:
+
+# GitHub URL - Leave blank if you don't want to display links to GitHub repo
+github_url:
+
+# Header quick link - This is usually a quick link to the service/product
+header_link_title:
+header_link_url:
+
+# TOC heading range
+toc_h_min: 2
+toc_h_max: 2
+toc_title: In this page
+
+# Other parameters
+next_reading_title: Next Reading
+related_title: Related Pages
+search: true
+nav_root_title: Docs
+
+
+
+### DO NOT CHANGE BELOW THIS LINE ###
+
+plugins:
+ - jekyll-sitemap
+ - jekyll-relative-links
+ - jekyll-include-cache
+
+permalink: /:categories/:title #:output_ext
+
+excerpt_separator:
+
+sass:
+ style: compressed
+ sass_dir: assets/_sass
+
+collections:
+ pages:
+ output: true
+ permalink: /:path
+ myassets:
+ output: true
+ permalink: /assets/:path
+ mydocs:
+ output: true
+ permalink: /:path
+
+relative_links:
+ enabled: true
+ collections: true
+
+exclude:
+ - "gemfiles/"
+ - "Gemfile"
+ - "Gemfile.lock"
+ - "*.code-workspace"
+ - "README.md"
+ - ".sass-cache/"
+ - ".jekyll-cache/"
+ - "package.json"
+ - "package-lock.json"
diff --git a/_docs/dax-internals/index.md b/_docs/dax-internals/index.md
deleted file mode 100644
index 14e047d..0000000
--- a/_docs/dax-internals/index.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-layout: home
-title: DAX Internals
-published: true
-order: /dax-internals
----
-
-Quick guide to DAX Internals: query plans, VertiPaq, DirectQuery, and other useful information.
-
-[**Optimization notes**](optimization-notes/index.md)
-
-[**VertiPaq**](vertipaq/index.md)
-
-[**DirectQuery**](directquery/index.md)
diff --git a/_docs/dax-internals/optimization-notes/index.md b/_docs/dax-internals/optimization-notes/index.md
deleted file mode 100644
index db0c8b3..0000000
--- a/_docs/dax-internals/optimization-notes/index.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-layout: page
-title: Optimization notes
-published: true
-order: /
----
-
-[**Horizontal Fusion**](horizontal-fusion.md)
-
-[**SWITCH optimization**](switch-optimization.md)
-
-[**IsAvailableInMDX Property**](isavailableinmdx-property.md)
\ No newline at end of file
diff --git a/_docs/dax-internals/vertipaq/index.md b/_docs/dax-internals/vertipaq/index.md
deleted file mode 100644
index 598a109..0000000
--- a/_docs/dax-internals/vertipaq/index.md
+++ /dev/null
@@ -1,13 +0,0 @@
----
-layout: page
-title: VertiPaq internals
-published: true
-order: /
----
-
-[**Logical Query Plan**](logical-query-plan.md)
-
-[**Physical Query Plan**](physical-query-plan.md)
-
-[**xmSQL**](xmSQL.md)
-
diff --git a/_includes/article.html b/_includes/article.html
new file mode 100644
index 0000000..5a0d920
--- /dev/null
+++ b/_includes/article.html
@@ -0,0 +1,42 @@
+
+
+
+
+ {% unless page.breadcrumbs == false %}
+ {% include breadcrumbs.html %}
+ {% endunless %}
+
+
{% endif %}
\ No newline at end of file
diff --git a/_includes/page-nav.html b/_includes/page-nav.html
index 8069da7..be7e03f 100644
--- a/_includes/page-nav.html
+++ b/_includes/page-nav.html
@@ -1,7 +1,7 @@
-
-
-