Quick start for the Litos theme: prerequisites, fork-or-template setup, and next steps.
This theme was developed during my free time, and the documentation may not be comprehensive enough, but I will try my best to explain it.
Prerequisiteh3
Before starting, ensure you have the following tools installed in your development environment:
- Node.js - Required for running the development environment.
- pnpm - Our preferred package manager for dependency management.
- Git - For version control and project management.
- VS Code - Recommended code editor with excellent development experience.
If you have other alternative tools, then you don’t need to follow the recommendations in this article.
Startup projecth3
There are two ways to do this:
- Fork the repository
- Use this template - In the future, content-free branches will be launched, which do not require deleting and replacing content.
After you have your own repository, you can clone it to your local machine.
Update Themeh3
When the theme releases a new version, you can pull the latest changes without losing your content by following these steps:
1. Add upstream remote (only needed once)
git remote add upstream https://github.com/Dnzzk2/Litos.git2. Fetch and merge the latest theme
git fetch upstreamgit merge upstream/main --no-edit3. Resolve conflicts (if any)
Conflicts typically only occur in files you have modified, such as src/config.ts. In that case, just keep your own configuration and accept the rest of the theme updates.
To minimize conflicts, try to only modify the following files:
src/config.ts— Site configurationsrc/content/— Your posts and projectspublic/— Your static assets (favicon, images, etc.).env— Environment variables
Avoid modifying theme source files (components, styles, layouts) directly. This ensures smooth updates every time.
Endh3
The following documents will be divided into pages, such as readme, posts…
Comments