Skip to content

mustakshif/Asri

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

English | ็ฎ€ไฝ“ไธญๆ–‡


banner

Asri, a theme for SiYuan

An ultra-modern theme for SiYuan Note, delivers an elegant, efficient, and personalized note-taking experience through its clean, intuitive design.

Latest Updates

v3.0.9

  • Optimized Japanese interface font.
  • Restored dynamic scrollbar style in the editing area.
  • Fine-tuned database view tabs' style.
  • Fixed the issue of input box display in the database template editing menu.
  • Fixed the problem of misalignment in the database line break switch.
  • Resolved some plugin style conflicts.

...

v3.0.0

custom theme color preview

๐ŸŽจ Refactored theme colors using a perceptual lightness-based color system, added supports for seamless adjustment of global color tones which can also follow system accent color (#Windows #macOS), providing a fully personalized note-taking experience. (Check Theme Configurations below for configuration options information)

Check all updates here.

Theme Features

๐Ÿช„ Sleek and Modern Design

  • ๐Ÿ‘จโ€๐ŸŽจ Unlimited theme color options allow for a fully personalized note-taking experience1
  • โš–๏ธ Top-bar Fusion seamlessly integrates the top bar and the tab bar2
  • ๐ŸงŠ Glassmorphism enhances the visual hierarchy
  • ๐ŸŒ“ Support for light and dark modes and smooth transition between them
  • โž– Minimized dividers create an integrated, cohesive interface style
  • โš™๏ธ Modernized designs for multiple kinds of components

๐Ÿ“ Elegant and Efficient Layout

  • ๐Ÿ”ข Tabular and database-friendly monospaced numerals improve reading efficiency
  • ๐Ÿ‘๏ธ High readability glyph variants tailored for note-taking scenarios3 #macOS #iOS #iPadOS
  • ๐Ÿฆ‹ Support for full-width display of images, videos, widgets, databases, superblocks and more, providing diverse layout options
  • ๐Ÿš Document-level text direction settings cater to different language layout needs
  • ๐Ÿงฉ Streamlined superblock margins for simplified creation of grid and masonry layouts

๐Ÿงญ Convenient and Clear Navigation

  • ๐Ÿ—‚๏ธ Indent guides for file tree and outline
  • ๐Ÿ” Clear presentation of search results and backlinks lists
  • โ†•๏ธ Enabled native scrollbar, which can auto-hide to minimize visual clutter #macOS

๐Ÿ‘† Nimble and Smooth Interaction

  • โฑ๏ธ Optimized timing of animations for better interface feedback, reducing user distraction
  • ๐Ÿ’ซ Appropriate and lively animations enrich the interactive experience
  • ๐Ÿš€ A high level of smooth performance maintained

Getting Started

  • Download & update in SiYuan (recommended): Go to Settings - Marketplace - Themes in SiYuan and search for "Asri" to download and apply.
  • Download & update from GitHub: Download the package.zip from releases, extract it to conf/appearance/themes in your SiYuan workspace, and restart SiYuan. Then choose "Asri" in your theme list in Settings - Appearance.

Theme Configurations

๐ŸŒˆ Customizing Theme Colors

asri config menu

Click on the Appearance Mode icon in the top right corner to open the Asri theme configuration menu and customize the theme colors:

  • Customize theme color: Use a custom color as the base color for the theme and apply a corresponding color scheme directly based on it.
  • Follow system accent color: Use the system's accent color as the base theme color. This option is enabled by default on Windows and macOS desktop platforms, and not visible on other platforms.
  • Chroma slider: Adjust the chroma of backgrounds and regular texts, with a range of 0 - 5, where 0 represents pure grayscale, and the default is 1.

๐Ÿ“ Custom Attributes

1. afwd: Asri full-width display

full-width-display preview

This attribute allows blocks to be displayed in full page width, which can be used to emphasize specific content or beautify the layout. The full-width display style applies to images, databases, iframes, tables and horizontal-layout superblocks.

Attribute Value Description
afwdใ€€ใ€€ - all (Makes all blocks that support this attribute in the document display in full width)
- p (Makes all images in the document display in full width)
- db (Makes all database blocks in the document display in full width)
- iframe (Makes all iframe blocks in the document display in full width, including videos, widgets, and embedded web pages)
- sb (Makes all horizontal-layout superblocks in the document display in full width)
- t (Makes all table blocks in the document display in full width)
Applies to document blocks.
All attribute values except all can be used simultaneously, and should be separated by spaces
afwdใ€€ใ€€ - on (Enable full-width display of the block individually)
- off (Disable full-width display of the block individually)
Applies to paragraph blocks, database blocks, iframe blocks, superblocks and table blocks.
Usage Examples

Applied to document blocks:

Attribute Value
afwd all / p sb iframe / db t / ...

Applied to supported content blocks:

Attribute Value
afwd on / off

In addition to adding custom attributes by shift + click block icon - Custom, you can also use the Attribute Quick Add plugin to quickly add this attribute to supported blocks. Here is a configuration example of the plugin:

{
    "@type/d": {
        "Full-width display for all supported blocks": {
            "afwd": "all"
        },
        "Full-width display for all database blocks and images": {
            "afwd": "db p"
        }
    },
    "Enable full-width display individually": {
        "afwd": "on"
    },
    "Disable full-width display individually": {
        "afwd": "off"
    }
}

The above configuration adds two options for document blocks and content blocks in the plugin menu, respectively, for quickly enabling and disabling the full-width display attribute for related content.

To restore the default state of the block, manually delete this custom attribute in the block attribute.

Precautions
  • Full-width display only applies to the first-level blocks in the document. If a block is nested in other content blocks, applying this attribute to it will not produce any effect. For example, applying this attribute to an image paragraph block in a blockquote will not change the style of the paragraph block unless the external blockquote is cancelled.
  • Full-width display is only effective in the editing area of the main window and small windows, and does not work in block reference preview windows, export previews, backlink panel, search result previews, etc.
  • Enabling full-width display may cause the page to feel more jumpy when the editing area's size changes and automatically returns to the cursor position.

2. tdir: Document text direction

Applies exclusively to document blocks, ensuring that content within the block is consistently rendered from left-to-right or right-to-left for ease of writing and reading. This property is independent of global settings and does not override individual layout settings of blocks within the document.

Attribute Value Description
tdir ltr Renders document content from left to right, ideal for left-to-right languages like Chinese and English.
tdir rtl Renders document content from right to left, ideal for right-to-left languages like Arabic.

This attribute does not take effect in backlink lists and export previews.

Acknowledgements

The theme development process drew inspiration from the following themes, and I would like to express my gratitude to their developers:

Reference Content From Theme Developer
- Menu background blur Cliff-Dark Crowds21
- Dots before sidebar panel list items
- Outline list item icons
- Status bar
- Seach list
- Table column width
- Multi-column / menu
- Bottom dock & status bar mergence
- Multilevel list style
Savor Roy
- Topbar-tabbar mergence
- File tree indent guides
- MutationObserver related functions
Rem Craft Seven Chord

๏ผˆThe order in the list above does not imply any ranking๏ผ‰

Feedbacks & suggestions

Notes

  • Settings window's dragable area is cut to the top area of the left column.
  • The close button in the upper right corner of the dialog box is hidden. To close the dialog box, click anywhere outside the dialog box.

Footnotes

  1. This new feature is only available on platforms that support oklch() and its relative color syntax. Some devices will still use color schemes in previous versions due to lower browser kernel versions. This feature is also disabled on iOS and iPadOS due to causing app crashes. โ†ฉ

  2. The blank area of the top bar can be used to drag the window (except for the gap between tabs). โ†ฉ

  3. To disable this feature or address glyph errors when using custom fonts, you can use the following CSS code snippet to restore to standard glyphs:

    .layout-tab-container, .protyle-content, .b3-typography {
        font-feature-settings: normal !important;
    }
    
    โ†ฉ