Finalize the documentation pages (#77)

- processing our special markdown notation [[ ]] still had numerous
issues, like parsed inside code blocks
- some markdown links still not skipped
- processing order of [[ ]] [[ | ]] was bogus
- added handling of a special form of our notation [[title|-]] that can
protect the given title from further autolink/tooltip processing
- prepared possible processing of our markdown notation in H2-H6
headings
- 
Signed-off-by: Hofi <[email protected]>

_data/excluded_titles.yml

@@ -11,3 +11,4 @@
 - '[Ii]nstallation'
 - '[Oo]ption[s]?'
 - '[Nn]ame'
+- 'syslog-ng OSE configuration'

_data/external_links.yml

@@ -37,6 +37,11 @@ gh-syslog-ng-doc:
   url: https://github.com/syslog-ng/syslog-ng.github.io
   title: [ "syslog-ng OSE Doc on GitHub" ]
 
+gh-syslog-ng-doc-actions:
+  id: gh-syslog-ng-doc-actions
+  url: https://github.com/syslog-ng/syslog-ng.github.io/actions
+  title: [ "syslog-ng Doc Actions on GitHub" ]
+
 gh-syslog-ng-doc-issue-tracker:
   id: gh-syslog-ng-doc-issue-tracker
   url: https://github.com/syslog-ng/syslog-ng.github.io/issues
@@ -180,6 +185,11 @@ lic-lgpl:
 
 ### Site engine related links ### 
 
+jekyll:
+  id: jekyll
+  url: https://jekyllrb.com/
+  title: [ "Jekyll" ]
+
 jekyll-config:
   id: jekyll-config
   url: https://jekyllrb.com/docs/configuration/
@@ -190,11 +200,41 @@ jekyll-dir-struct:
   url: https://jekyllrb.com/docs/structure/
   title: [ "Jekyll doc structure" ]
 
+jekyll-sass:
+  id: jekyll-sass
+  url: https://jekyllrb.com/docs/assets/#sassscss
+  title: [ "Jekyll Sass" ]
+
 jekyll-ruby-gems:
   id: jekyll-ruby-gems
   url: https://jekyllrb.com/docs/ruby-101/
   title: [ "Jekyll Ruby Gems" ]
 
+jekyll-liquid-filters:
+  id: jekyll-liquid-filters
+  url: https://jekyllrb.com/docs/liquid/filters/
+  title: [ "Jekyll liquid filter" ]
+
+jekyll-plugins:
+  id: jekyll-plugins
+  url: https://jekyllrb.com/docs/plugins/
+  title: [ "Jekyll plugin" ]
+
+jekyll-render-hooks:
+  id: jekyll-render-hooks
+  url: https://jekyllrb.com/docs/plugins/hooks/
+  title: [ "Jekyll plugin Hooks" ]
+
+liquid:
+  id: liquid
+  url: https://shopify.github.io/liquid/
+  title: [ "liquid" ]
+
+liquify-rb:
+  id: liquify-rb
+  url: https://fettblog.eu/snippets/jekyll/liquid-in-frontmatter/
+  title: [ "liquify.rb" ]
+
 lunr-search-help:
   id: lunr-search-help
   url: https://lunrjs.com/guides/searching.html
@@ -238,6 +278,26 @@ apple-launchd:
   url: https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html
   title: [ "Apple launchd" ]
 
+apple-predicates:
+  id: apple-predicates
+  url: https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/Predicates/Articles/pSyntax.html
+  title: [ "native macOS log message filtering using predicates" ]
+
+apple-oslog-api:
+  id: apple-oslog-api
+  url: https://developer.apple.com/documentation/os/oslog
+  title: [ "OSLog API" ]
+
+apple-oslog-api-bug:
+  id: apple-oslog-api-bug
+  url: https://openradar.appspot.com/radar?id=5597032077066240
+  title: [ "OSLog API bug" ]
+
+apple-oslog-framwrk:
+  id: apple-oslog-framwrk
+  url: https://developer.apple.com/documentation/oslog?language=objc
+  title: [ "OSLog Framework" ]
+
 autoconf-arch:
   id: autoconf-arch
   url: http://www.gnu.org/software/autoconf-archive/
@@ -388,21 +448,6 @@ linux-ha:
   url: https://web.archive.org/web/20230422234943/http://www.linux-ha.org/wiki/Main_Page
   title: [ "archived page of Linux-HA" ]
 
-nat-macos:
-  id: nat-macos
-  url: https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/Predicates/Articles/pSyntax.html
-  title: [ "native macOS log message filtering using predicates" ]
-
-oslog-api-bug:
-  id: oslog-api-bug
-  url: https://openradar.appspot.com/radar?id=5597032077066240
-  title: [ "OSLog API bug" ]
-
-oslog-fra:
-  id: oslog-fra
-  url: https://developer.apple.com/documentation/oslog?language=objc
-  title: [ "OSLog Framework" ]
-
 proxy-pro:
   id: proxy-pro
   url: https://www.haproxy.com/blog/haproxy/proxy-protocol/

_includes/doc/common_links

@@ -3,10 +3,10 @@
     This could help common link usages, like
 
     {% include doc/common_links %}
-    [404 link via ref][ref:404]
+    {% include markdown_link_decl id="404" %}
 
     The final goal would be to add include of this file to _includes/doc/common_snippets and get it
-    automatically included to each page, so make possible pure 
+    automatically included to each page, so make possible a pure 
 
     [404 link via ref][ref:404]
 

_js/custom/custom-init.js

@@ -1,11 +1,3 @@
 /* ==========================================================================
-   Custom js init stuff
-   ========================================================================== */
-
-// $(function () {
-// 
-//   // Override the default lunr tokenizer options, as a quick fix added _ to the list to get ignored the differences like option-1 and option_1
-//   //lunr.tokenizer.separator = /[\s\-_]+/
-//   lunr.tokenizer.separator = /[\s]+/
-// 
-// });
+   Add custom, common js initialization related part here
+   ========================================================================== */