Obsidian - это бесплатное приложение для создания и хранения заметок. Устанавливается локально на компьютере пользователя. Заметки создаются в очень легком текстовом формате markdown. Каждая заметка доступна как отдельный файл в директории и может быть открыта любым совместимым редактором, например, Sublime Text.
Obsidian бесплатный, но за синхронизацию его с облаком потребуется оплатить подписку. Возможно, использовать Google Disk, OneDrive и другие облачные хранилища.
Для того, чтобы сделать из заметок на компьютере статический сайт, используется приложение Quartz, доступное на GitHub. Ниже написал инструкцию, которую сам и использую.
Руководство по установке на английском:
Требуются приложения
- Node v22
npmv10.9.2git
Инициализация
git clone https://github.com/jackyzha0/quartz.git
cd quartz
npm i
npx quartz createКонтент
В директории quartz надо найти директорию content
В ней будет находится все содержание сайта
В Obsidian надо подключить эту директорию как vault
Запустить сайт локально, для проверки
npx quartz build --serve
GitHub
Create a new repository on GitHub.com. Do not initialize the new repository with README, license, or gitignore files.
# list all the repositories that are tracked
git remote -v
# if the origin doesn't match your own repository, set your repository as the origin
git remote set-url origin REMOTE-URL
# if you don't have upstream as a remote, add it so updates work
git remote add upstream https://github.com/jackyzha0/quartz.gitIn future updates, you can simply run npx quartz sync every time you want to push updates to your repository.
GitHub Pages
Руководство по созданию сайта на GitHub
- В директории Quartz сделать файл с конфигурацией quartz/.github/workflows/deploy.yml. Делал это через Sublime Text
- Head to “Settings” tab of your forked repository and in the sidebar, click “Pages”. Under “Source”, select “GitHub Actions”.
- Commit these changes by doing
npx quartz sync. This should deploy your site to<github-username>.github.io/<repository-name>.