Valaxy API Docs

Appearance

Interface: SiteConfig ​

Defined in: packages/valaxy/types/config.ts:43

Properties ​

author ​

ts
author: object;

Defined in: packages/valaxy/types/config.ts:97

The owner of this blog

avatar ​

ts
avatar: string;

email ​

ts
email: string;

intro? ​

ts
optional intro: string;
Zh ​

个人简介

ts
link: string;

name ​

ts
name: string;

Your name

Description ​

你的名字

status ​

ts
status: object;

The status of you

Description ​

状态

status.emoji ​
ts
emoji: string;

Emoji representation of your status like '👨‍💻'

Description ​

你的状态的 Emoji 表示，如 '👨‍💻'

status.message ​
ts
message: string;

show when hover emoji

Description ​

当鼠标悬浮在图标上时显示

Description ​

博客作者

cdn ​

ts
cdn: object;

Defined in: packages/valaxy/types/config.ts:237

third-party plugin need cdn aplayer, twikoo

prefix ​

ts
prefix: string;

prefix for your third-party

Default ​
ts
'https://unpkg.com/'

Default ​

ts
'https://unpkg.com/'

codeHeightLimit? ​

ts
optional codeHeightLimit: number;

Defined in: packages/valaxy/types/config.ts:392

@description:en-US Limit the height of the code block in px @description:zh-CN 限制代码块的高度，单位是 px

comment ​

ts
comment: object;

Defined in: packages/valaxy/types/config.ts:228

comment: waline/...

enable ​

ts
enable: boolean;

description ​

ts
description: string;

Defined in: packages/valaxy/types/config.ts:92

站点描述

encrypt ​

ts
encrypt: object;

Defined in: packages/valaxy/types/config.ts:373

algorithm ​

ts
algorithm: string;

encrypt

Default ​
ts
AES-CBC

enable ​

ts
enable: boolean;

iv ​

ts
iv: Uint8Array;

salt ​

ts
salt: Uint8Array;

Description ​

Encrypt article @description:zh-CN 加密文章 default algorithm: AES-CBC

favicon ​

ts
favicon: string;

Defined in: packages/valaxy/types/config.ts:149

icon for your website

feed ​

ts
feed: object;

Defined in: packages/valaxy/types/config.ts:151

favicon ​

ts
favicon: string;

name ​

ts
name: string;

name: feed -> feed.xml / feed.atom / feed.json

Default ​
ts
'' -> feed.xml / atom.xml / feed.json

floatingVue ​

ts
floatingVue: any;

Defined in: packages/valaxy/types/config.ts:336

Floating Vue configuration for floating footnote tooltips.

See ​

https://floating-vue.starpad.dev/guide/config

frontmatter ​

ts
frontmatter: Partial<PostFrontMatter>;

Defined in: packages/valaxy/types/config.ts:223

set post default frontmatter

fuse ​

ts
fuse: object;

Defined in: packages/valaxy/types/config.ts:190

fuse search

dataPath ​

ts
dataPath: string;
Default ​
ts
'valaxy-fuse-list.json'
Description ​

搜索结果列表数据所在路径

options ​

ts
options: FuseOptions<FuseListItem> & object;
Type Declaration ​
keys ​
ts
keys: FuseOptionKey<FuseListItem>[] | undefined;

@en_US The fields to be searched. @zh_CN 搜索的字段

Default ​
ts
['title', 'tags', 'categories', 'excerpt']
@description:en-US List of keys that will be searched. This supports nested paths, weighted search, and searching in arrays of strings and objects
@description:zh-CN 搜索将会涉及的字段列表，支持嵌套路径、加权搜索以及在字符串和对象数组中进行搜索
See ​

https://fusejs.io/api/options.html#keys

See ​

https://fusejs.io/api/options.html

pattern? ​

ts
optional pattern: string;

fast-glob pattern to match Fuse List Data

Default ​

pages/**/*.md

ts
await fg(`${userRoot}/pages/posts/**/*.md`)

See ​

https://fusejs.io/

Description ​

本地搜索 Please set search.type to 'fuse'

lang ​

ts
lang: string;

Defined in: packages/valaxy/types/config.ts:54

Default language

Description ​

默认语言，设置 zh-CN 以改变默认语言为中文

Default ​

ts
'en'

languages ​

ts
languages: string[];

Defined in: packages/valaxy/types/config.ts:63

alternative languages

Description ​

可选语言

En ​

If you want to disable multi-language support for your site, you can set this to only include one language (e.g. ['en'])

Zh ​

如果你想要禁言站点的多语言支持，可以将此项设置为仅包含一个语言 (例如 ['zh-CN'])

Default ​

ts
['en', 'zh-CN']

See ​

https://ogp.me/#optional

lastUpdated ​

ts
lastUpdated: boolean;

Defined in: packages/valaxy/types/config.ts:144

show last updated time by git/mtime

Default ​

ts
false

license ​

ts
license: object;

Defined in: packages/valaxy/types/config.ts:250

The license of your posts

enabled ​

ts
enabled: boolean;

Whether to show at the bottom of the article

Description ​

是否显示在文章底部

Default ​
ts
true

language ​

ts
language: string;

Creative License Language, same with your config.lang when lang === 'zh-CN', use 'zh'

Description ​

默认与站点语言相同

Default ​
ts
'en'

type ​

ts
type: "zero" | "by-sa" | "by-nd" | "by-nc" | "by-nc-sa" | "by-nc-nd";

Type of license

Description ​

证书类型

Default ​
ts
'by-nc-sa'

Description ​

文章所使用的协议，默认使用 Creative Commons

Default ​

ts
https://creativecommons.org/licenses/

mediumZoom ​

ts
mediumZoom: object;

Defined in: packages/valaxy/types/config.ts:305

image preview by medium-zoom

enable ​

ts
enable: boolean;
Zh ​

启用图片预览

options ​

ts
options: ZoomOptions;
Zh ​

配置项

See ​

https://github.com/francoischalifour/medium-zoom#options

selector ​

ts
selector: string | HTMLElement | HTMLElement[];

For example: '.markdown-body img'

Default ​
ts
'' content.value querySelectorAll('img')

Url ​

https://github.com/francoischalifour/medium-zoom

mode ​

ts
mode: "light" | "dark" | "auto";

Defined in: packages/valaxy/types/config.ts:48

enable auto (light/dark mode)

Default ​

ts
'auto'

orderBy ​

ts
orderBy: "date" | "updated";

Defined in: packages/valaxy/types/config.ts:138

order posts by 'date' or 'updated'

  • date: 按创建时间排序
  • updated: 按最后更新时间排序

当开启 lastUpdated 时，updated 会按照文件的更新时间自动赋值

Default ​

ts
'date'

pageSize ​

ts
pageSize: number;

Defined in: packages/valaxy/types/config.ts:342

displayed posts length in every page

Default ​

ts
7

redirects? ​

ts
optional redirects: object;

Defined in: packages/valaxy/types/config.ts:398

@description:en-US client redirect rules @description:zh-CN 客户端重定向规则

rules? ​

ts
optional rules: RedirectRule[];

useVueRouter? ​

ts
optional useVueRouter: boolean;
ts
search: object;

Defined in: packages/valaxy/types/config.ts:169

enable ​

ts
enable: boolean;
Zh ​

是否启用

type ​

ts
type: "algolia" | "engine" | "fuse";

Search Type

  • algolia: Algolia Search
  • engine: Engine Search, like Google/Baidu
  • fuse: Local Search by fuse.js

En ​

search engine for your site

Zh ​

搜索功能

social ​

ts
social: SocialLink[];

Defined in: packages/valaxy/types/config.ts:163

社交链接

ts
sponsor: object;

Defined in: packages/valaxy/types/config.ts:276

donate for author

description? ​

ts
optional description: string;

Donate content description

Description ​

打赏的描述内容，在按钮下方所有图片上方，与图片一起折叠

Default ​
ts
undefined 不显示内容

enable ​

ts
enable: boolean;

methods ​

ts
methods: object[];
Zh ​

赞助方式

title? ​

ts
optional title: string;

Donate button title attribute

Description ​

打赏按钮的 title 属性

Default ​
ts
zh:'打赏' en:'Donate'

Description ​

打赏/赞助

statistics ​

ts
statistics: object;

Defined in: packages/valaxy/types/config.ts:348

statistics readingTime and wordCount

enable ​

ts
enable: boolean;

readTime ​

ts
readTime: object;
readTime.speed ​
ts
speed: object;
readTime.speed.cn ​
ts
cn: number;

Chinese word count speed

Description ​

中文每分钟阅读字数

Default ​
ts
300 (300 字/分钟)
readTime.speed.en ​
ts
en: number;

English word count speed

Description ​

英文每分钟阅读字数

Default ​
ts
100 (200 字/分钟)

Description ​

统计阅读时间和字数

subtitle ​

ts
subtitle: string;

Defined in: packages/valaxy/types/config.ts:88

副标题

timezone ​

ts
timezone: string;

Defined in: packages/valaxy/types/config.ts:78

See ​

https://wikipedia.org/wiki/List_of_tz_database_time_zones @en_US Timezone configuration @zh_CN 时区配置，国内推荐使用 'Asia/Shanghai' @description:en-US This configuration is used to generate times with timezone when no timezone is set @description:zh-CN 当时间没有设置时区时，使用该配置生成带时区的时间

Default ​

ts
''

title ​

ts
title: string;

Defined in: packages/valaxy/types/config.ts:84

Site title

Description ​

站点标题

url ​

ts
url: string;

Defined in: packages/valaxy/types/config.ts:79

vanillaLazyload ​

ts
vanillaLazyload: object;

Defined in: packages/valaxy/types/config.ts:327

lazyload by vanilla-lazyload and markdown-it-image-figures when vanillaLazyLoad.enable is true, imageFigures removeSrc is true, classes is 'lazy'

enable ​

ts
enable: boolean;

options ​

ts
options: ILazyLoadOptions;

See ​

https://github.com/verlok/vanilla-lazyload