GitHub даёт возможность бесплатно создать свой несложный веб-сайт без рекламы, я вот нисколько не плачу за хостинг этого сайта. Этот гайд расчитан на то, что вы умейте пользоваться Git, освоить его несложно, в интернете полно туториалов о том, как создать репозиторий и загрузить на него файлы.
Возможно вы видели всякие сайты на github.io. Чтобы сделать также, достаточно просто создать репизоторий юзернейм.github.io, например как у меня. Работает это также как Neocities или Народ, просто загружайте свои веб-страницы и они хостятся. Файл index.html будет открываться по ссылке на ваш сайт, таким образом у меня работает “хоумпейдж”.
Для персональной wiki (это то, что вы прямо сейчас читайте) я воспользовалась статическим генератором сайтов Quartz от jackyzha0.
Чтобы сделать себе такой же, надо перейти на репозиторий генератора и скопировать шаблон себе выбрав пункт Use this template и в нём Create a new repository
Вводим Repository name, оно будет использоваться в ссылке на ваш вебсайт —вашеимя.github.io/имярепозитория, у меня это nichloya.github.io/recipes
Тада! Теперь нужно поменять настройки сайту, это делается в файле quartz.config.ts, в нём нужно обязательно поменять baseUrl на ваш URL. Параметр pageTitle меняет название текст на кнопке, которая возвращает на главную страницу, а изменив locale на "ru-RU" можно заменить язык на великий и могучий.
Теперь можно заливать свои страницы, чтобы что-то добавить на него, нужно добавить файлы в формате Markdown в папку content. Главной страницей будет файл index.md. Чтобы было легко писать заметки, просто откройте папку content в Obsidian, как раз под него и делался Quartz.
Чтобы врубить сборку и хостинг сайта, нужно в репозитории создать файл .github/workflows/deploy.yml (если что .github и workflows это папки внутри друг друга) с вот таким содержимым:
name: Deploy Quartz site to GitHub Pages
on:
push:
branches:
- v4
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: "pages"
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0 # Fetch all history for git info
- uses: actions/setup-node@v4
with:
node-version: 22
- name: Install Dependencies
run: npm ci
- name: Build Quartz
run: npx quartz build
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: public
deploy:
needs: build
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
После чего на странице своего репозитория, выбрать вкладку Settings, там перейти в Pages и выбрать Github Actions как source
Теперь ваш сайт в wiki формате будет доступен по ссылке вашеимя.github.io/имярепозитория.