feat: site test

Author: Emir Aganovic

.gitignore

@@ -1,4 +1,4 @@
-*
-
-!.gitignore
-!README.md
+/README.md
+/diago-site
+*.svg
+*.png

404.html

@@ -0,0 +1,27 @@
+<div style='font-family:system-ui,"Segoe UI",Roboto,Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji"; height:100vh; text-align:center; display:flex; flex-direction:column; align-items:center; justify-content:center'>
+  <div>
+    <style>
+      body {
+        color: #000;
+        background: #fff;
+        margin: 0;
+      }
+      .next-error-h1 {
+        border-right: 1px solid rgba(0, 0, 0, 0.3);
+      }
+      @media (prefers-color-scheme: dark) {
+        body {
+          color: #fff;
+          background: #000;
+        }
+        .next-error-h1 {
+          border-right: 1px solid rgba(255, 255, 255, 0.3);
+        }
+      }
+    </style>
+    <h1 class="next-error-h1" style='display: inline-block; margin: 0 20px 0 0; padding-right: 23px; font-size: 24px; font-weight: 500; vertical-align: top; line-height: 49px; font-feature-settings: "rlig" 1,"calt" 1,"ss01" 1,"ss06" 1 !important;'>404</h1>
+    <div style="display: inline-block; text-align: left">
+      <h2 style="font-size: 14px; font-weight: 400; line-height: 49px; margin: 0">This page could not be found.</h2>
+    </div>
+  </div>
+</div>

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

categories/index.html

@@ -0,0 +1,18 @@
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Diago – Categories</title>
+    <link>https://diago.org/categories/</link>
+    <description>Recent content in Categories on Diago</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	  <atom:link href="https://diago.org/categories/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+      
+        
+      
+    
+    
+  </channel>
+</rss>

categories/index.xml

@@ -0,0 +1,18 @@
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Diago – Guide</title>
+    <link>https://diago.org/docs/guide/</link>
+    <description>Recent content in Guide on Diago</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	  <atom:link href="https://diago.org/docs/guide/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+      
+        
+      
+    
+    
+  </channel>
+</rss>

css/compiled/main.css

@@ -0,0 +1 @@
+{"/docs/getting_started/":{"data":{"#":"Getting starteddiago acts as UAS(User Agent Server) and UAC(User Agent Client). For now it keeps abstractions only where it needs. Therefore it distincts your dialog control by:\nIt receives DialogServerSession for serving incoming sessions(Call leg) It creates DialogClientSession when it Dials outgoing session(Call leg) Further it is explicit which media stack it uses\nAnswer -\u003e RTP/UDP AnswerWebrtc -\u003e Webrtc stack SRTP/DTLS Setup diago: ua, _ := sipgo.NewUA() transportUDP := diago.Transport{ Transport: \"udp\", BindHost: \"127.0.0.1\", BindPort: 5060, } transportTCP := diago.Transport{ Transport: \"tcp\", BindHost: \"127.0.0.1\", BindPort: 5060, } d := diago.NewDiago(ua, diago.WithTransport(transportUDP), diago.WithTransport(transportTCP), ) Incoming call d.Serve(ctx, func(inDialog *diago.DialogServerSession) { // - Do your call routing. switch inDialog.ToUser() { case \"answer\": case \"123456\" } }) Outgoing dialog, err := d.Dial(ctx, recipient sip.Uri, bridge *Bridge, opts sipgo.AnswerOptions) dialog.Hangup() ","answering-call#Answering call":" func Answer(inDialog *diago.DialogServerSession) { inDialog.Progress() // Progress -\u003e 100 Trying inDialog.Ringing() // Ringing -\u003e 180 Response if err := inDialog.Answer(); err != nil { fmt.Println(\"Failed to answer\", err) return } ctx := inDialog.Context() select { case \u003c-ctx.Done(): case \u003c-time.After(1 * time.Minute): } } ","getting-started#Getting started":"","playing-file-with-playback#Playing file with Playback":"Playing file is done by playback.\nSupported formats:\nwav (PCM) func Playback(inDialog *diago.DialogServerSession) { inDialog.Ringing() playfile, err := os.Open(\"demo-instruct.wav\") if err != nil { fmt.Println(\"Failed to open file\", err) return } pb, err := inDialog.PlaybackCreate() if err != nil { fmt.Println(\"Failed to create playback\", err) return } if err := inDialog.Answer(); err != nil { fmt.Println(\"Failed to answer\", err) return } if err := pb.Play(playfile, \"audio/wav\"); err != nil { fmt.Println(\"Playing failed\", err) } } "},"title":"getting_started"}}

css/compiled/main.min.c1fe2c80102c9dc9ddc66184191e646769052d36a21b38ac5ab5077713cf7a81.css

@@ -0,0 +1,398 @@
+// Search functionality using FlexSearch.
+
+// Change shortcut key to cmd+k on Mac, iPad or iPhone.
+document.addEventListener("DOMContentLoaded", function () {
+  if (/iPad|iPhone|Macintosh/.test(navigator.userAgent)) {
+    // select the kbd element under the .search-wrapper class
+    const keys = document.querySelectorAll(".search-wrapper kbd");
+    keys.forEach(key => {
+      key.innerHTML = '<span class="hx-text-xs">⌘</span>K';
+    });
+  }
+});
+
+// Render the search data as JSON.
+// 
+// 
+// 
+// 
+
+(function () {
+  const searchDataURL = '/en.search-data.json';
+
+  const inputElements = document.querySelectorAll('.search-input');
+  for (const el of inputElements) {
+    el.addEventListener('focus', init);
+    el.addEventListener('keyup', search);
+    el.addEventListener('keydown', handleKeyDown);
+    el.addEventListener('input', handleInputChange);
+  }
+
+  const shortcutElements = document.querySelectorAll('.search-wrapper kbd');
+
+  function setShortcutElementsOpacity(opacity) {
+    shortcutElements.forEach(el => {
+      el.style.opacity = opacity;
+    });
+  }
+
+  function handleInputChange(e) {
+    const opacity = e.target.value.length > 0 ? 0 : 100;
+    setShortcutElementsOpacity(opacity);
+  }
+
+  // Get the search wrapper, input, and results elements.
+  function getActiveSearchElement() {
+    const inputs = Array.from(document.querySelectorAll('.search-wrapper')).filter(el => el.clientHeight > 0);
+    if (inputs.length === 1) {
+      return {
+        wrapper: inputs[0],
+        inputElement: inputs[0].querySelector('.search-input'),
+        resultsElement: inputs[0].querySelector('.search-results')
+      };
+    }
+    return undefined;
+  }
+
+  const INPUTS = ['input', 'select', 'button', 'textarea']
+
+  // Focus the search input when pressing ctrl+k/cmd+k or /.
+  document.addEventListener('keydown', function (e) {
+    const { inputElement } = getActiveSearchElement();
+    if (!inputElement) return;
+
+    const activeElement = document.activeElement;
+    const tagName = activeElement && activeElement.tagName;
+    if (
+      inputElement === activeElement ||
+      !tagName ||
+      INPUTS.includes(tagName) ||
+      (activeElement && activeElement.isContentEditable))
+      return;
+
+    if (
+      e.key === '/' ||
+      (e.key === 'k' &&
+        (e.metaKey /* for Mac */ || /* for non-Mac */ e.ctrlKey))
+    ) {
+      e.preventDefault();
+      inputElement.focus();
+    } else if (e.key === 'Escape' && inputElement.value) {
+      inputElement.blur();
+    }
+  });
+
+  // Dismiss the search results when clicking outside the search box.
+  document.addEventListener('mousedown', function (e) {
+    const { inputElement, resultsElement } = getActiveSearchElement();
+    if (!inputElement || !resultsElement) return;
+    if (
+      e.target !== inputElement &&
+      e.target !== resultsElement &&
+      !resultsElement.contains(e.target)
+    ) {
+      setShortcutElementsOpacity(100);
+      hideSearchResults();
+    }
+  });
+
+  // Get the currently active result and its index.
+  function getActiveResult() {
+    const { resultsElement } = getActiveSearchElement();
+    if (!resultsElement) return { result: undefined, index: -1 };
+
+    const result = resultsElement.querySelector('.active');
+    if (!result) return { result: undefined, index: -1 };
+
+    const index = parseInt(result.dataset.index, 10);
+    return { result, index };
+  }
+
+  // Set the active result by index.
+  function setActiveResult(index) {
+    const { resultsElement } = getActiveSearchElement();
+    if (!resultsElement) return;
+
+    const { result: activeResult } = getActiveResult();
+    activeResult && activeResult.classList.remove('active');
+    const result = resultsElement.querySelector(`[data-index="${index}"]`);
+    if (result) {
+      result.classList.add('active');
+      result.focus();
+    }
+  }
+
+  // Get the number of search results from the DOM.
+  function getResultsLength() {
+    const { resultsElement } = getActiveSearchElement();
+    if (!resultsElement) return 0;
+    return resultsElement.dataset.count;
+  }
+
+  // Finish the search by hiding the results and clearing the input.
+  function finishSearch() {
+    const { inputElement } = getActiveSearchElement();
+    if (!inputElement) return;
+    hideSearchResults();
+    inputElement.value = '';
+    inputElement.blur();
+  }
+
+  function hideSearchResults() {
+    const { resultsElement } = getActiveSearchElement();
+    if (!resultsElement) return;
+    resultsElement.classList.add('hx-hidden');
+  }
+
+  // Handle keyboard events.
+  function handleKeyDown(e) {
+    const { inputElement } = getActiveSearchElement();
+    if (!inputElement) return;
+
+    const resultsLength = getResultsLength();
+    const { result: activeResult, index: activeIndex } = getActiveResult();
+
+    switch (e.key) {
+      case 'ArrowUp':
+        e.preventDefault();
+        if (activeIndex > 0) setActiveResult(activeIndex - 1);
+        break;
+      case 'ArrowDown':
+        e.preventDefault();
+        if (activeIndex + 1 < resultsLength) setActiveResult(activeIndex + 1);
+        break;
+      case 'Enter':
+        e.preventDefault();
+        if (activeResult) {
+          activeResult.click();
+        }
+        finishSearch();
+      case 'Escape':
+        e.preventDefault();
+        hideSearchResults();
+        // Clear the input when pressing escape
+        inputElement.value = '';
+        inputElement.dispatchEvent(new Event('input'));
+        // Remove focus from the input
+        inputElement.blur();
+        break;
+    }
+  }
+
+  // Initializes the search.
+  function init(e) {
+    e.target.removeEventListener('focus', init);
+    if (!(window.pageIndex && window.sectionIndex)) {
+      preloadIndex();
+    }
+  }
+
+  /**
+   * Preloads the search index by fetching data and adding it to the FlexSearch index.
+   * @returns {Promise<void>} A promise that resolves when the index is preloaded.
+   */
+  async function preloadIndex() {
+    const tokenize = 'forward';
+    window.pageIndex = new FlexSearch.Document({
+      tokenize,
+      cache: 100,
+      document: {
+        id: 'id',
+        store: ['title'],
+        index: "content"
+      }
+    });
+
+    window.sectionIndex = new FlexSearch.Document({
+      tokenize,
+      cache: 100,
+      document: {
+        id: 'id',
+        store: ['title', 'content', 'url', 'display'],
+        index: "content",
+        tag: 'pageId'
+      }
+    });
+
+    const resp = await fetch(searchDataURL);
+    const data = await resp.json();
+    let pageId = 0;
+    for (const route in data) {
+      let pageContent = '';
+      ++pageId;
+
+      for (const heading in data[route].data) {
+        const [hash, text] = heading.split('#');
+        const url = route.trimEnd('/') + (hash ? '#' + hash : '');
+        const title = text || data[route].title;
+
+        const content = data[route].data[heading] || '';
+        const paragraphs = content.split('\n').filter(Boolean);
+
+        sectionIndex.add({
+          id: url,
+          url,
+          title,
+          pageId: `page_${pageId}`,
+          content: title,
+          ...(paragraphs[0] && { display: paragraphs[0] })
+        });
+
+        for (let i = 0; i < paragraphs.length; i++) {
+          sectionIndex.add({
+            id: `${url}_${i}`,
+            url,
+            title,
+            pageId: `page_${pageId}`,
+            content: paragraphs[i]
+          });
+        }
+
+        pageContent += ` ${title} ${content}`;
+      }
+
+      window.pageIndex.add({
+        id: pageId,
+        title: data[route].title,
+        content: pageContent
+      });
+
+    }
+  }
+
+  /**
+   * Performs a search based on the provided query and displays the results.
+   * @param {Event} e - The event object.
+   */
+  function search(e) {
+    const query = e.target.value;
+    if (!e.target.value) {
+      hideSearchResults();
+      return;
+    }
+
+    const { resultsElement } = getActiveSearchElement();
+    while (resultsElement.firstChild) {
+      resultsElement.removeChild(resultsElement.firstChild);
+    }
+    resultsElement.classList.remove('hx-hidden');
+
+    const pageResults = window.pageIndex.search(query, 5, { enrich: true, suggest: true })[0]?.result || [];
+
+    const results = [];
+    const pageTitleMatches = {};
+
+    for (let i = 0; i < pageResults.length; i++) {
+      const result = pageResults[i];
+      pageTitleMatches[i] = 0;
+
+      // Show the top 5 results for each page
+      const sectionResults = window.sectionIndex.search(query, 5, { enrich: true, suggest: true, tag: `page_${result.id}` })[0]?.result || [];
+      let isFirstItemOfPage = true
+      const occurred = {}
+
+      for (let j = 0; j < sectionResults.length; j++) {
+        const { doc } = sectionResults[j]
+        const isMatchingTitle = doc.display !== undefined
+        if (isMatchingTitle) {
+          pageTitleMatches[i]++
+        }
+        const { url, title } = doc
+        const content = doc.display || doc.content
+
+        if (occurred[url + '@' + content]) continue
+        occurred[url + '@' + content] = true
+        results.push({
+          _page_rk: i,
+          _section_rk: j,
+          route: url,
+          prefix: isFirstItemOfPage ? result.doc.title : undefined,
+          children: { title, content }
+        })
+        isFirstItemOfPage = false
+      }
+    }
+    const sortedResults = results
+      .sort((a, b) => {
+        // Sort by number of matches in the title.
+        if (a._page_rk === b._page_rk) {
+          return a._section_rk - b._section_rk
+        }
+        if (pageTitleMatches[a._page_rk] !== pageTitleMatches[b._page_rk]) {
+          return pageTitleMatches[b._page_rk] - pageTitleMatches[a._page_rk]
+        }
+        return a._page_rk - b._page_rk
+      })
+      .map(res => ({
+        id: `${res._page_rk}_${res._section_rk}`,
+        route: res.route,
+        prefix: res.prefix,
+        children: res.children
+      }));
+    displayResults(sortedResults, query);
+  }
+
+  /**
+   * Displays the search results on the page.
+   *
+   * @param {Array} results - The array of search results.
+   * @param {string} query - The search query.
+   */
+  function displayResults(results, query) {
+    const { resultsElement } = getActiveSearchElement();
+    if (!resultsElement) return;
+
+    if (!results.length) {
+      resultsElement.innerHTML = `<span class="no-result">No results found.</span>`;
+      return;
+    }
+
+    // Highlight the query in the result text.
+    function highlightMatches(text, query) {
+      const escapedQuery = query.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&');
+      const regex = new RegExp(escapedQuery, 'gi');
+      return text.replace(regex, (match) => `<span class="match">${match}</span>`);
+    }
+
+    // Create a DOM element from the HTML string.
+    function createElement(str) {
+      const div = document.createElement('div');
+      div.innerHTML = str.trim();
+      return div.firstChild;
+    }
+
+    function handleMouseMove(e) {
+      const target = e.target.closest('a');
+      if (target) {
+        const active = resultsElement.querySelector('a.active');
+        if (active) {
+          active.classList.remove('active');
+        }
+        target.classList.add('active');
+      }
+    }
+
+    const fragment = document.createDocumentFragment();
+    for (let i = 0; i < results.length; i++) {
+      const result = results[i];
+      if (result.prefix) {
+        fragment.appendChild(createElement(`
+          <div class="prefix">${result.prefix}</div>`));
+      }
+      let li = createElement(`
+        <li>
+          <a data-index="${i}" href="${result.route}" class=${i === 0 ? "active" : ""}>
+            <div class="title">`+ highlightMatches(result.children.title, query) + `</div>` +
+        (result.children.content ?
+          `<div class="excerpt">` + highlightMatches(result.children.content, query) + `</div>` : '') + `
+          </a>
+        </li>`);
+      li.addEventListener('mousemove', handleMouseMove);
+      li.addEventListener('keydown', handleKeyDown);
+      li.querySelector('a').addEventListener('click', finishSearch);
+      fragment.appendChild(li);
+    }
+    resultsElement.appendChild(fragment);
+    resultsElement.dataset.count = results.length;
+  }
+})();

css/custom.css

@@ -0,0 +1,17 @@
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Diago – Welcome to diago</title>
+    <link>https://diago.org/</link>
+    <description>Recent content in Welcome to diago on Diago</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	  <atom:link href="https://diago.org/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+      
+      
+    
+    
+  </channel>
+</rss>

css/custom.min.e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855.css

@@ -0,0 +1,275 @@
+// Light / Dark theme toggle
+(function () {
+  const defaultTheme = 'system'
+
+  const themeToggleButtons = document.querySelectorAll(".theme-toggle");
+
+  // Change the icons of the buttons based on previous settings or system theme
+  if (
+    localStorage.getItem("color-theme") === "dark" ||
+    (!("color-theme" in localStorage) &&
+      ((window.matchMedia("(prefers-color-scheme: dark)").matches && defaultTheme === "system") || defaultTheme === "dark"))
+  ) {
+    themeToggleButtons.forEach((el) => el.dataset.theme = "dark");
+  } else {
+    themeToggleButtons.forEach((el) => el.dataset.theme = "light");
+  }
+
+  // Add click event handler to the buttons
+  themeToggleButtons.forEach((el) => {
+    el.addEventListener("click", function () {
+      if (localStorage.getItem("color-theme")) {
+        if (localStorage.getItem("color-theme") === "light") {
+          setDarkTheme();
+          localStorage.setItem("color-theme", "dark");
+        } else {
+          setLightTheme();
+          localStorage.setItem("color-theme", "light");
+        }
+      } else {
+        if (document.documentElement.classList.contains("dark")) {
+          setLightTheme();
+          localStorage.setItem("color-theme", "light");
+        } else {
+          setDarkTheme();
+          localStorage.setItem("color-theme", "dark");
+        }
+      }
+      el.dataset.theme = document.documentElement.classList.contains("dark") ? "dark" : "light";
+    });
+  });
+
+  // Listen for system theme changes
+  window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", (e) => {
+    if (defaultTheme === "system" && !("color-theme" in localStorage)) {
+      e.matches ? setDarkTheme() : setLightTheme();
+      themeToggleButtons.forEach((el) =>
+        el.dataset.theme = document.documentElement.classList.contains("dark") ? "dark" : "light"
+      );
+    }
+  });
+})();
+
+;
+// Hamburger menu for mobile navigation
+
+document.addEventListener('DOMContentLoaded', function () {
+  const menu = document.querySelector('.hamburger-menu');
+  const overlay = document.querySelector('.mobile-menu-overlay');
+  const sidebarContainer = document.querySelector('.sidebar-container');
+
+  // Initialize the overlay
+  const overlayClasses = ['hx-fixed', 'hx-inset-0', 'hx-z-10', 'hx-bg-black/80', 'dark:hx-bg-black/60'];
+  overlay.classList.add('hx-bg-transparent');
+  overlay.classList.remove("hx-hidden", ...overlayClasses);
+
+  function toggleMenu() {
+    // Toggle the hamburger menu
+    menu.querySelector('svg').classList.toggle('open');
+
+    // When the menu is open, we want to show the navigation sidebar
+    sidebarContainer.classList.toggle('max-md:[transform:translate3d(0,-100%,0)]');
+    sidebarContainer.classList.toggle('max-md:[transform:translate3d(0,0,0)]');
+
+    // When the menu is open, we want to prevent the body from scrolling
+    document.body.classList.toggle('hx-overflow-hidden');
+    document.body.classList.toggle('md:hx-overflow-auto');
+  }
+
+  menu.addEventListener('click', (e) => {
+    e.preventDefault();
+    toggleMenu();
+
+    if (overlay.classList.contains('hx-bg-transparent')) {
+      // Show the overlay
+      overlay.classList.add(...overlayClasses);
+      overlay.classList.remove('hx-bg-transparent');
+    } else {
+      // Hide the overlay
+      overlay.classList.remove(...overlayClasses);
+      overlay.classList.add('hx-bg-transparent');
+    }
+  });
+
+  overlay.addEventListener('click', (e) => {
+    e.preventDefault();
+    toggleMenu();
+
+    // Hide the overlay
+    overlay.classList.remove(...overlayClasses);
+    overlay.classList.add('hx-bg-transparent');
+  });
+});
+
+;
+// Copy button for code blocks
+
+document.addEventListener('DOMContentLoaded', function () {
+  const getCopyIcon = () => {
+    const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+    svg.innerHTML = `
+      <path stroke-linecap="round" stroke-linejoin="round" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
+    `;
+    svg.setAttribute('fill', 'none');
+    svg.setAttribute('viewBox', '0 0 24 24');
+    svg.setAttribute('stroke', 'currentColor');
+    svg.setAttribute('stroke-width', '2');
+    return svg;
+  }
+
+  const getSuccessIcon = () => {
+    const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+    svg.innerHTML = `
+      <path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7" />
+    `;
+    svg.setAttribute('fill', 'none');
+    svg.setAttribute('viewBox', '0 0 24 24');
+    svg.setAttribute('stroke', 'currentColor');
+    svg.setAttribute('stroke-width', '2');
+    return svg;
+  }
+
+  document.querySelectorAll('.hextra-code-copy-btn').forEach(function (button) {
+    // Add copy and success icons
+    button.querySelector('.copy-icon')?.appendChild(getCopyIcon());
+    button.querySelector('.success-icon')?.appendChild(getSuccessIcon());
+
+    // Add click event listener for copy button
+    button.addEventListener('click', function (e) {
+      e.preventDefault();
+      // Get the code target
+      const target = button.parentElement.previousElementSibling;
+      let codeElement;
+      if (target.tagName === 'CODE') {
+        codeElement = target;
+      } else {
+        // Select the last code element in case line numbers are present
+        const codeElements = target.querySelectorAll('code');
+        codeElement = codeElements[codeElements.length - 1];
+      }
+      if (codeElement) {
+        let code = codeElement.innerText;
+        // Replace double newlines with single newlines in the innerText
+        // as each line inside <span> has trailing newline '\n'
+        if ("lang" in codeElement.dataset) {
+          code = code.replace(/\n\n/g, '\n');
+        }
+        navigator.clipboard.writeText(code).then(function () {
+          button.classList.add('copied');
+          setTimeout(function () {
+            button.classList.remove('copied');
+          }, 1000);
+        }).catch(function (err) {
+          console.error('Failed to copy text: ', err);
+        });
+      } else {
+        console.error('Target element not found');
+      }
+    });
+  });
+});
+
+;
+document.querySelectorAll('.hextra-tabs-toggle').forEach(function (button) {
+  button.addEventListener('click', function (e) {
+    // set parent tabs to unselected
+    const tabs = Array.from(e.target.parentElement.querySelectorAll('.hextra-tabs-toggle'));
+    tabs.map(tab => tab.dataset.state = '');
+
+    // set current tab to selected
+    e.target.dataset.state = 'selected';
+
+    // set all panels to unselected
+    const panelsContainer = e.target.parentElement.parentElement.nextElementSibling;
+    Array.from(panelsContainer.children).forEach(function (panel) {
+      panel.dataset.state = '';
+    });
+
+    const panelId = e.target.getAttribute('aria-controls');
+    const panel = panelsContainer.querySelector(`#${panelId}`);
+    panel.dataset.state = 'selected';
+  });
+});
+
+;
+(function () {
+  const languageSwitchers = document.querySelectorAll('.language-switcher');
+  languageSwitchers.forEach((switcher) => {
+    switcher.addEventListener('click', (e) => {
+      e.preventDefault();
+      switcher.dataset.state = switcher.dataset.state === 'open' ? 'closed' : 'open';
+      const optionsElement = switcher.nextElementSibling;
+      optionsElement.classList.toggle('hx-hidden');
+
+      // Calculate position of language options element
+      const switcherRect = switcher.getBoundingClientRect();
+      const translateY = switcherRect.top - window.innerHeight - 15;
+      optionsElement.style.transform = `translate3d(${switcherRect.left}px, ${translateY}px, 0)`;
+      optionsElement.style.minWidth = `${Math.max(switcherRect.width, 50)}px`;
+    });
+  });
+
+  // Dismiss language switcher when clicking outside
+  document.addEventListener('click', (e) => {
+    if (e.target.closest('.language-switcher') === null) {
+      languageSwitchers.forEach((switcher) => {
+        switcher.dataset.state = 'closed';
+        const optionsElement = switcher.nextElementSibling;
+        optionsElement.classList.add('hx-hidden');
+      });
+    }
+  });
+})();
+
+;
+// Script for filetree shortcode collapsing/expanding folders used in the theme
+// ======================================================================
+document.addEventListener("DOMContentLoaded", function () {
+  const folders = document.querySelectorAll(".hextra-filetree-folder");
+  folders.forEach(function (folder) {
+    folder.addEventListener("click", function () {
+      Array.from(folder.children).forEach(function (el) {
+        el.dataset.state = el.dataset.state === "open" ? "closed" : "open";
+      });
+      folder.nextElementSibling.dataset.state = folder.nextElementSibling.dataset.state === "open" ? "closed" : "open";
+    });
+  });
+});
+
+;
+document.addEventListener("DOMContentLoaded", function () {
+  const buttons = document.querySelectorAll(".hextra-sidebar-collapsible-button");
+  buttons.forEach(function (button) {
+    button.addEventListener("click", function (e) {
+      e.preventDefault();
+      const list = button.parentElement.parentElement;
+      if (list) {
+        list.classList.toggle("open")
+      }
+    });
+  });
+});
+
+;
+// Back to top button
+
+document.addEventListener("DOMContentLoaded", function () {
+  const backToTop = document.querySelector("#backToTop");
+  if (backToTop) {
+    document.addEventListener("scroll", (e) => {
+      if (window.scrollY > 300) {
+        backToTop.classList.remove("hx-opacity-0");
+      } else {
+        backToTop.classList.add("hx-opacity-0");
+      }
+    });
+  }
+});
+
+function scrollUp() {
+  window.scroll({
+    top: 0,
+    left: 0,
+    behavior: "smooth",
+  });
+}

docs/getting_started/index.html

@@ -0,0 +1,20 @@
+{
+  "name": "Hextra",
+  "short_name": "Hextra",
+  "start_url": "index.html",
+  "icons": [
+    {
+      "src": "android-chrome-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "android-chrome-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ],
+  "theme_color": "#000000",
+  "background_color": "#000000",
+  "display": "standalone"
+}

docs/guide/index.html

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:xhtml="http://www.w3.org/1999/xhtml">
+  <url>
+    <loc>https://diago.org/docs/guide/</loc>
+  </url><url>
+    <loc>https://diago.org/docs/getting_started/</loc>
+  </url><url>
+    <loc>https://diago.org/categories/</loc>
+  </url><url>
+    <loc>https://diago.org/docs/</loc>
+  </url><url>
+    <loc>https://diago.org/tags/</loc>
+  </url><url>
+    <loc>https://diago.org/</loc>
+  </url>
+</urlset>

docs/guide/index.xml

@@ -0,0 +1,18 @@
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Diago – Tags</title>
+    <link>https://diago.org/tags/</link>
+    <description>Recent content in Tags on Diago</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	  <atom:link href="https://diago.org/tags/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+      
+        
+      
+    
+    
+  </channel>
+</rss>