Rework expressions

Author: asdine

config.toml

@@ -16,8 +16,24 @@ defaultContentLanguageInSubdir = false
 # Useful when translating.
 enableMissingTranslationPlaceholders = true
 
+# Comment out to disable taxonomies in Docsy
 disableKinds = ["taxonomy", "taxonomyTerm"]
 
+# You can add your own taxonomies
+# [taxonomies]
+# tag = "tags"
+# category = "categories"
+
+# [params.taxonomy]
+# # set taxonomyCloud = [] to hide taxonomy clouds
+# taxonomyCloud = ["tags", "categories"] 
+
+# # If used, must have same lang as taxonomyCloud
+# taxonomyCloudTitle = ["Tag Cloud", "Categories"] 
+
+# # set taxonomyPageHeader = [] to hide taxonomies on the page headers
+# taxonomyPageHeader = ["tags", "categories"] 
+
 # Highlighting config
 pygmentsCodeFences = true
 pygmentsUseClasses = false
@@ -69,12 +85,21 @@ weight = 1
     [markup.goldmark.renderer]
       unsafe = true
   [markup.highlight]
+      # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html
+      style = "tango"
+      # Uncomment if you want your chosen highlight style used for code blocks without a specified language
+      # guessSyntax = "true"
       guessSyntax = "false"
 
 # Everything below this are Site Params
 
+# Comment out if you don't want the "print entire section" link enabled.
+[outputs]
+section = ["HTML", "print", "RSS"]
+
 [params]
 copyright = "Asdine El Hrychy"
+# privacy_policy = "https://policies.google.com/privacy"
 
 # First one is picked as the Twitter card image if not set on page.
 # images = ["images/project-illustration.png"]
@@ -95,13 +120,17 @@ version = "0.0"
 
 # A link to latest version of the docs. Used in the "version-banner" partial to
 # point people to the main doc site.
-url_latest_version = "https://genji.dev/docs/"
+url_latest_version = "https://genji.dev/"
 
 # Repository configuration (URLs for in-page links to opening issues and suggesting changes)
 github_repo = "https://github.com/genjidb/docs"
 
 # Specify a value here if your content directory is not in your repo's root directory
-github_subdir = ""
+# github_subdir = ""
+
+# Uncomment this if you have a newer GitHub repo with "main" as the default branch,
+# or specify a new value if you want to reference another branch in your GitHub links
+# github_branch= "main"
 
 # Google Custom Search Engine ID. Remove or comment out to disable search.
 # gcs_engine_id = ""
@@ -112,18 +141,23 @@ algolia_docsearch = false
 # Enable Lunr.js offline search
 offlineSearch = true
 
+# Enable syntax highlighting and copy buttons on code blocks with Prism
+prism_syntax_highlighting = false
+
 # User interface configuration
 [params.ui]
-# Enable to show the side bar menu in its compact state.
-sidebar_menu_compact = false
 #  Set to true to disable breadcrumb navigation.
 breadcrumb_disable = false
-#  Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
-sidebar_search_disable = false
-#  Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar
-navbar_logo = true
 # Set to true to disable the About link in the site footer
 footer_about_disable = true
+#  Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar
+navbar_logo = true
+# Set to true if you don't want the top navbar to be translucent when over a `block/cover`, like on the homepage.
+navbar_translucent_over_cover_disable = false
+# Enable to show the side bar menu in its compact state.
+sidebar_menu_compact = false
+#  Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
+sidebar_search_disable = false
 
 # Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events.
 # This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set.
@@ -135,9 +169,13 @@ enable = true
 yes = 'Glad to hear it! Please <a href="https://github.com/genjidb/docs/issues/new">tell us how we can improve</a>.'
 no = 'Sorry to hear that. Please <a href="https://github.com/genjidb/docs/issues/new">tell us how we can improve</a>.'
 
-[params.links]
-# End user relevant links. These will show up on left side of footer and in the community page if you have one.
+# Adds a reading time to the top of each doc.
+# If you want this feature, but occasionally need to remove the Reading time from a single page, 
+# add "hide_readingtime: true" to the page's front matter
+[params.ui.readingtime]
+enable = false
 
+[params.links]
 # Developer relevant links. These will show up on right side of footer and in the community page if you have one.
 [[params.links.developer]]
 	name ="Twitter"

content/en/docs/genji-sql/_index.md content/en/docs/essentials/_index.md

@@ -1,8 +1,7 @@
 ---
-title: "Genji SQL"
+title: "Essentials"
 date: 2020-03-29T18:30:57+04:00
 weight: 30
 description: >
   How to create and manage database structures using Genji SQL syntax
 ---
-

content/en/docs/genji-sql/data-types.md content/en/docs/essentials/data-types.md

@@ -31,7 +31,7 @@ In Genji, _NULL_ is treated as both a value and a type. It represents the absenc
 Whenever Genji needs to manipulate data of different types, depending on the situation it will rely on either:
 
 - **explicit conversion**: The source type and destination type are clearly identified. Ex: When inserting data to field with a constraint or when doing a `CAST`.
-- **implicit conversion**: Two values of different types need to be compared or used by an operator during the evaluation of an [expression]({{< relref "/docs/genji-sql/expressions.md" >}})
+- **implicit conversion**: Two values of different types need to be compared or used by an operator during the evaluation of an [expression]({{< relref "/docs/essentials/expressions.md" >}})
 
 ### Explicit conversion
 
@@ -61,5 +61,5 @@ Here is a table describing type compatibility.
 
 ### Implicit conversion
 
-There is only one kind of implicit conversion: `INTEGER` to `DOUBLE`. This usually takes place during the evaluation of an [expression]({{< relref "/docs/genji-sql/expressions" >}}) involving INTEGER and DOUBLE values.
+There is only one kind of implicit conversion: `INTEGER` to `DOUBLE`. This usually takes place during the evaluation of an [expression]({{< relref "/docs/essentials/expressions" >}}) involving INTEGER and DOUBLE values.
 No other conversion is applied unless it's explicit.

content/en/docs/genji-sql/deleting-documents.md content/en/docs/essentials/deleting-documents.md

@@ -22,6 +22,6 @@ To delete only a few documents, use the `WHERE` clause:
 DELETE FROM users WHERE age > 13;
 ```
 
-For every document, the `WHERE` clause evaluates any [expression]({{< relref "/docs/genji-sql/expressions" >}}) that follows, here `age > 13`. If the result is truthy, the document gets deleted.
+For every document, the `WHERE` clause evaluates any [expression]({{< relref "/docs/essentials/expressions" >}}) that follows, here `age > 13`. If the result is truthy, the document gets deleted.
 
 The `DELETE` statement doesn't return an error if no document matches the `WHERE` clause, or if there aren't any document in the table.