Skip to content

Version 1.11.0
Compare
Choose a tag to compare
@marjune163 marjune163 released this 21 Mar 08:31
· 402 commits to main since this release
v1.11.0
30f331b

Main changes

Breaking change: add theme support

Before

To specify a custom html template for file list page, use --template
to specify that file.

After

The template file, together with assets like CSS or JS, are archived
into a zip file as theme file. Use --theme to specify that theme file.

  • use --theme to specify theme(zip) file
  • remove --template to specify page template
  • template file is now inside theme file
--theme <file>
    Specify a zip archive file as custom theme for rendering page and assets, instead of builtin ones.
    Theme contents are cached in memory at runtime.
--theme-dir <directory>
    Specify a directory which contains theme files.
    Theme contents will be evaluated for each request.
    It is convenient for developing themes.

    Notes for theme options:
        --theme and --theme-dir are mutually exclusive.
        --theme-dir is prior.
        Page template filename is always "index.html".
        Use "?asset=<asset-path>" to reference an asset in theme.

Improvements

  • feat(serverHandler/page): compress file list page if possible

Output gzip/deflate compressed content for file list page if client supports.

  • feat(tpl): add translation support

Detect acceptable language from client and render proper language.
Suported languages are en-US, zh-CN, zh-TW and zh-HK.

  • feat(json): add isVirtual field to item for aliased directory
  • fix(json): output subItems for empty-root mode

主要变更

破坏性变更：添加主题支持

之前

要为文件列表页指定自定义模板，使用--template指定该文件。

之后

模板文件，以及其他静态资源如CSS和JS，将被一起打包进一个zip文件，作为主题文件。
使用--theme指定该文件。

  • 使用--theme指定主题（zip）文件
  • 移除用于指定模板的--template
  • 模板文件现在位于主题文件中
--theme <主题文件>
    指定用于渲染页面和静态资源的自定义主题zip压缩文件，代替内建主题。
    主题的内容在运行时一直缓存在内存中。
--theme-dir <主题目录>
    指定主题文件所在的目录。
    每次请求时主题内容都会重新计算。
    这为开发主题提供了便利。

    主题选项注意事项：
        --theme和--theme-dir是互斥的。
        --theme-dir更为优先。
        页面模板文件名固定为“index.html”。
        使用“?asset=<asset-path>”格式来引用主题中的静态资源。

改进

  • feat(serverHandler/page): 如果可能，文件列表页启用压缩

如果客户端支持，为文件列表页输出用gzip/deflate压缩过的内容

  • feat(tpl): 添加翻译支持

检测客户端可接受的语言并渲染正确的语言。
支持的语言为en-US，zh-CN，zh-TW和zh-HK。

  • feat(json): 添加isVirtual字段用来表示别名目录
  • fix(json): 修复为空虚拟根目录输出子项
Assets 29
Loading