Twilight

Site & Localization#

• Language & Translation: Enable client-side translation using site.translate.enable. You can choose different services and configure auto-detection.

• Custom Fonts: Add your own fonts by providing a CSS link or file path under site.font.

Visual Effects#

• Theme Color: Change the primary color of your blog by adjusting the site.themeColor.hue (0-360).

• Wallpaper Modes: Choose between banner, fullscreen, or none. You can also enable a carousel for multiple wallpapers with the kenBurns effect.

• Waves Effect: Toggle the animated water ripple effect on the banner using site.wallpaper.banner.waves.enable.

• Particle Effects: Enable floating particles in the background with particle.enable.

UI#

• Navbar Transparency: Adjust site.wallpaper.banner.navbar.transparentMode between semi, full, or semifull.

• Sidebar Widgets: Reorder or toggle sidebar components like profile, announcement, categories, tags, toc, and statistics in sidebar.components.

GitHub Repository Cards#

You can add dynamic cards that link to GitHub repositories, on page load, the repository information is pulled from the GitHub API.

Create a GitHub repository card with the code ::github{repo="Spr-Aachen/Twilight"}.

1
::github{repo="Spr-Aachen/Twilight"}

Admonitions#

Following types of admonitions are supported: note tip important warning caution

NOTE

Highlights information that users should take into account, even when skimming.

TIP

Optional information to help a user be more successful.

IMPORTANT

Crucial information necessary for users to succeed.

WARNING

Critical content demanding immediate user attention due to potential risks.

CAUTION

Negative potential consequences of an action.

• Basic Syntax

  1
  :::note
  2
  Highlights information that users should take into account, even when skimming.
  3
  :::
  4
  
  5
  :::tip
  6
  Optional information to help a user be more successful.
  7
  :::

• Custom Titles

  The title of the admonition can be customized.

  MY CUSTOM TITLE

  This is a note with a custom title.

  1
  :::note[MY CUSTOM TITLE]
  2
  This is a note with a custom title.
  3
  :::

• GitHub Syntax

  TIP

  The GitHub syntax is also supported.

  1
  > [!TIP]
  2
  > The GitHub syntax is also supported.

• Spoiler

  You can add spoilers to your text. The text also supports Markdown syntax.

  The content is hidden ayyy!

  1
  The content :spoiler[is hidden **ayyy**]!

For more details, check the Documentation.