Getting started
Local
Installing prerequisites
Open powershell and run this:
# Download and install Chocolatey:
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"
# Download and install Git:
choco install git
# Verify Git version:
git -v
# Download and install Node.js:
choco install nodejs
# Verify the Node.js version:
node -v
# Download and install pnpm:
corepack enable pnpm
# Verify pnpm version:
pnpm -v
Deployment
If you want to learn how to deploy the website online, read the official vitepress docs.
Icon
Wotaku fetches icons using Iconfiy. To get the icon names, visit Iconify or Icones. All the added iconpacks are here.
Writing Rules
Section | Style |
---|---|
In-line | :package name-icon name: |
Button | :i-package name-icon name: |
Typescript | <span class="i-package-name:icon-name"></span> |
Index.md | SVG Code |
Using Alias
Most used icons have been shortened using Alias. You can find them in sheet. They work in-line, not inside button. You have to use the traditional method.
Twitter emoji
Twitter emoji is the default iconpack for wotaku. For twemoji, you don't have to mention twemoji. just icon name.
Commands
Job | CMD |
---|---|
Adding iconpack | pnpm add -D @iconify-json/<packname> |
Remove iconpack | pnpm remove @iconify-json/<packname> |
You have to add the iconpack manually in docs\.vitepress\configs\emoji.ts
. Otherwise it wont work. Follow the already added ones as example.
Rules
- Follow the order of the tabs in sheet
- There will be no space between icons. Just at the beginning.
- Icons will be after main URL
- Then github/gitlab or similar source link button
- Then related buttons like Extensions, Alts, Proxies etc
- Unlike icons, there will be space between buttons (so that it is easy to click).
- If there is an icon for that button (example: GitHub), use icon. Otherwise normal button.
- Tooltip will always be at the end.
Adding tooltips
To learn, how to add tooltips, click here.
Sheet
Icon | Code | Desc |
---|---|---|
:s: | Favorite | |
:e: | Extension(s) | |
:prx: | Proxies | |
:ero: | Focuses on NSFW content | |
:acc: | Needs Account | |
:help: | Help / Docs | |
:more: | Related resources |
Tooltip
Tooltip is used to give extra information. The information should be precise. No need of stating something obvious. Tooltip has two components. The key will be beside the URL in the markdown file and key data will be in docs\.vitepress\configs\markdown\index.ts
. The key is case-sensitive.
// Single line
key: { content: "markdown" }
// Single line with other variables
key2: {
title: "key2",
icon: "i-material-symbols-info-i",
content: "content"
}
// Multi line with other variables
multiline: {
title: "multiline",
icon: "i-material-symbols-info-i",
content: `This is **markdown** with
- A bullet point
- Another bullet point`
}
There is also
^[inline tooltips](just like this)
Front matter
Moved
Check the front matter description here.