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"}

Music Cards

• Online

1
::music{meting="https://api.i-meto.com/meting/api?server=netease&type=song&id=1390882521"}

• Local

1
::music{title="深海之息" artist="Youzee Music" cover="https://p1.music.126.net/PhKOqFtljgHDDpKYM2ADUA==/109951169858309716.jpg" audio="assets/music/深海之息.m4a" lrc="assets/music/深海之息.lrc"}

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.