site/README.md

68 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<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. Сохраняем.