From 4d6c5d0041c335ce2c2eae0deebcbc986e0814aa Mon Sep 17 00:00:00 2001 From: Elke Zimoch Date: Wed, 4 Feb 2026 15:49:46 +0100 Subject: [PATCH] following the example to set up a webpage - step 3 --- .../EPICS_black_blue_logo_rgb_small_v03.jpg | Bin 0 -> 9318 bytes zensical.toml | 132 ++++++++++++++++++ 2 files changed, 132 insertions(+) create mode 100644 images/EPICS_black_blue_logo_rgb_small_v03.jpg create mode 100644 zensical.toml diff --git a/images/EPICS_black_blue_logo_rgb_small_v03.jpg b/images/EPICS_black_blue_logo_rgb_small_v03.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d270cc74e7195fc25c2520967f73981788f49147 GIT binary patch literal 9318 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 V75%ldSN8y2yq@jL+wuG5{{Ym1?#}=K literal 0 HcmV?d00001 diff --git a/zensical.toml b/zensical.toml new file mode 100644 index 0000000..38b7161 --- /dev/null +++ b/zensical.toml @@ -0,0 +1,132 @@ +# ============================================================================ +# +# This configuration was copied from the linux/documentation repository +# +# ============================================================================ + +[project] + +repo_url = "https://gitea.psi.ch/epics_training/epics_training_webpages" +edit_uri = "_edit/main/docs/" + +# The site_name is shown in the page header and the browser window title +site_name = "EPICS Training at PSI" + +# The site_description is included in the HTML head and should contain a +# meaningful description of the site content for use by search engines. +site_description = """ +This is the collection of all EPICS Training webpages at PSI provided by the section Controls in AEK. +""" + +site_author = "Paul Scherrer Institute" + +site_url = "https://epics_training.pages.psi.ch/epics_training_webpages/" + +# The copyright notice appears in the page footer and can contain an HTML +# fragment. +copyright = """ +Copyright © 2026 Paul Scherrer Institute +""" + +# ---------------------------------------------------------------------------- +# Section for configuring theme options +# ---------------------------------------------------------------------------- +[project.theme] + +language = "en" + +# Zensical provides a number of feature toggles that change the behavior +# of the documentation site. +features = [ + # Zensical includes an announcement bar. This feature allows users to + # dismiss it then they have read the announcement. + "announce.dismiss", + + # If you have a repository configured and turn feature this on, Zensical + # will generate an edit button for the page. This works for common + # repository hosting services. + "content.action.edit", + + # Code annotations allow you to add an icon with a tooltip to your + # code blocks to provide explanations at crucial points. + "content.code.annotate", + + # This feature turns on a button in code blocks that allow users to + # copy the content to their clipboard without first selecting it. + "content.code.copy", + + + # Code blocks can include a button to allow for the selection of line + # ranges by the user. + "content.code.select", + + # Zensical can render footnotes as inline tooltips, so the user can read + # the footnote without leaving the context of the document. + "content.footnote.tooltips", + + # If you have many content tabs that have the same titles (e.g., "Python", + # "JavaScript", "Cobol"), this feature causes all of them to switch to + # at the same time when the user chooses their language in one. + "content.tabs.link", + + "content.tooltips", + + # This feature turns on navigation elements in the footer that allow the + # user to navigate to a next or previous page. + "navigation.footer", + + # When section index pages are enabled, documents can be directly attached + # to sections, which is particularly useful for providing overview pages. + "navigation.indexes", + + # When instant navigation is enabled, clicks on all internal links will be + # intercepted and dispatched via XHR without fully reloading the page. + "navigation.instant", + + # With instant prefetching, your site will start to fetch a page once the + # user hovers over a link. This will reduce the perceived loading time + # for the user. + "navigation.instant.prefetch", + + # When navigation paths are activated, a breadcrumb navigation is rendered + # above the title of each page + "navigation.path", + + # When search highlighting is enabled and a user clicks on a search result, + # Zensical will highlight all occurrences after following the link. + "search.highlight", + + # A back-to-top button can be shown when the user, after scrolling down, + # starts to scroll up again. + "navigation.top", + + + # When anchor tracking is enabled, the URL in the address bar is + # automatically updated with the active anchor as highlighted in the table + # of contents. + "navigation.tracking", +] + + +# ---------------------------------------------------------------------------- +# In the "palette" subsection you can configure options for the color scheme. +# You can configure different color # schemes, e.g., to turn on dark mode, +# that the user can switch between. Each color scheme can be further +# customized. +# Read more: +# - https://zensical.org/docs/setup/colors/ +# ---------------------------------------------------------------------------- + +[[project.theme.palette]] +scheme = "default" +toggle.icon = "lucide/sun" +toggle.name = "Switch to dark mode" + +[[project.theme.palette]] +scheme = "slate" +toggle.icon = "lucide/moon" +toggle.name = "Switch to light mode" + +[project.theme.icon] +logo = "simple/gitea" +repo = "simple/gitea"