68 lines
3.6 KiB
Markdown
68 lines
3.6 KiB
Markdown
<h1 align="center">
|
||
Сайт группы
|
||
</h1>
|
||
|
||
## Требования
|
||
- Node.js версии не ниже 8 и менеджер пакетов npm
|
||
- Gatsby CLI
|
||
- Git
|
||
|
||
## Запуск локально
|
||
Клонируем репозиторий, переходим в директорию сайта. Добавляем переменную окружения, в неё прописываем путь до npm.
|
||
Устанавливаем нужные пакеты командой `npm install`. Gatsby CLI устанавливается командой `npm install -g gatsby-cli`.
|
||
|
||
Открываем командную строку, в ней пишем:
|
||
```shell
|
||
gatsby develop
|
||
```
|
||
При успешном запуске будет виден порт, на котором запускается сайт (обычно это `http://localhost:8000`).
|
||
|
||
## Содержимое папки
|
||
|
||
├── src
|
||
├── components
|
||
├── content
|
||
├── files
|
||
├── images
|
||
├── intl
|
||
├── pages
|
||
├── styles
|
||
├── static
|
||
├── admin
|
||
├── files
|
||
├── images
|
||
├── .gitignore
|
||
├── gatsby-config.js
|
||
├── gatsby-node.js
|
||
├── package-lock.json
|
||
├── package.json
|
||
└── README.md
|
||
|
||
Все исходники лежат в `src`.
|
||
- **/components** - элементы страницы, такие как _навигационная панель, подвал, основные стили._
|
||
- **/images** и **/files** - изображения и файлы, которые используются на сайте.
|
||
- **/intl** - содержит элементы локализации.
|
||
- **/pages** - основной контент, * *.js-файлы трогать не нужно.* Все markdown-файлы находятся в папке `content`
|
||
- **/styles** - стили сайта.
|
||
|
||
В `static` находятся настройки административной панели и статические файлы. В неё добавляются вручную такие файлы, как pdf-документы, в остальных случаях её трогать не нужно.
|
||
|
||
- Файл `gatsby-config.js` предназначен для внесения плагинов.
|
||
- В `gatsby-node.js` хранится код для преобразования .md-файлов в страницы.
|
||
|
||
## Деплой
|
||
Для деплоя сайта нужно в командной строке прописать `npm run deploy`.
|
||
|
||
## Редактирование
|
||
Для редактирования сайта существуют два способа: локально и с помощью Netlify CMS.
|
||
|
||
### **Локально**
|
||
1. В папке `/src/content` вносим изменения в существующие markdown-файлы, добавляем новые, удаляем ненужные.
|
||
2. Добавляем при необходимости изображения в папку `/src/images`.
|
||
3. В командной строке переходим в директорию сайта, запускаем `gatsby develop`, локально проверяем, как выглядит.
|
||
4. Делаем коммит изменений, пушим в репозиторий на Github на ветку dev.
|
||
|
||
### **С помощью Netlify CMS**
|
||
1. К пути сайта добавляем `/admin`, оказываемся в панели администратора.
|
||
2. Вносим нужные изменения.
|
||
3. Сохраняем. |