https://github.com/cdefgah/poetica
This application created to help managing poetry contest. The contest is being carried out in Russian and for this reason the application description, interface and documentation are in Russian only.
https://github.com/cdefgah/poetica
angular java poetry poetry-contest
Last synced: 4 months ago
JSON representation
This application created to help managing poetry contest. The contest is being carried out in Russian and for this reason the application description, interface and documentation are in Russian only.
- Host: GitHub
- URL: https://github.com/cdefgah/poetica
- Owner: cdefgah
- License: gpl-3.0
- Created: 2020-09-12T23:55:53.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-08-19T10:50:20.000Z (almost 2 years ago)
- Last Synced: 2024-11-29T13:18:47.611Z (6 months ago)
- Topics: angular, java, poetry, poetry-contest
- Language: Java
- Homepage:
- Size: 2.2 MB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Poetica Project
#### Актуальная версия [0.94.7 от 26 декабря 2021 года](https://github.com/cdefgah/poetica/releases/tag/v0.94.7).
[Информация о сборке](https://github.com/cdefgah/poetica/blob/master/src/main/resources/other/whatsnew.txt)
Проект Poetica призван помочь оператору дежурной команды провести тур чемпионата по [бескрылкам](https://ru.wikipedia.org/wiki/%D0%91%D0%B5%D1%81%D0%BA%D1%80%D1%8B%D0%BB%D0%BA%D0%B0).
Информация о том, как скачать и запустить готовую программу, а также остальная пользовательская документация по проекту находятся по ссылке: [https://github.com/cdefgah/poetica/wiki/Poetica](https://github.com/cdefgah/poetica/wiki/Poetica)
## Сборка проекта
Для самостоятельной сборки проекта из исходных кодов необходимо установить на компьютер следующие инструменты:
* [Java SE (Standard Edition) SDK](http://java.sun.com) версии не ниже 1.8;
* [Node.JS](https://nodejs.org/en/) версия 12.18.4;
* [Angular](https://angular.io/), версия 11.0.5, если будете использовать более новые версии Angular, возможно потребуется мигрировать проект;
* [Apache Maven](https://maven.apache.org/) актуальной версии. Пропишите путь к папке `bin` в Apache Maven в системную переменную окружения `PATH`, чтобы команда `mvn` была доступна из любой папки.
Установка Node.JS и Angular делается следующим образом:
1. Скачиваете и устанавливаете Node.JS
2. Открываете терминал и даёте команду (Linux-пользователям надо добавить перед командой `sudo `):
`npm install -g typescript`
Эта команда установит поддержку typescript.
3. Затем в этом-же терминале даёте команду (Linux-пользователям надо добавить перед командой `sudo `):
`npm install -g @angular/[email protected]`
После этого даёте команду в терминале:
`ng --version`
Должна отобразиться информация об установленном Angular и его компонентах. В информации о компонентах не должно быть никаких сообщений об ошибках. Если они есть, переустановите эти компоненты отдельно.
Если это первая сборка проекта, то перейдите в папку `src/main/frontend`, откройте терминал в этой папке и дайте команду:
`npm install`
Это установит все необходимые зависимости для сборки части проекта, построенной на Angular.
Затем, в корневой папке проекта (там, где находится файл `pom.xml`), в терминале дайте команду:
`mvn clean package`
После выполнения сборки, из папки `target` забирайте файл `poetica-x.xx.x-distrib.zip`, где `x.xx.x` - номер версии, например: `poetica-0.94.6-distrib.zip`.
Внутри этого zip-архива находится папка со всеми файлами приложения. Просто распакуйте этот архив и следуйте [инструкциям пользовательской документации по запуску приложения](https://github.com/cdefgah/poetica/wiki/%D0%9E-%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B5).
В текущем архиве дистрибутива файл приложения имеет расширение `.dat` вместо `.jar`, это сделано специально, чтобы Windows-пользователи не запустили программу, случайно кликнув по файлу мышкой.
Ибо в таком случае jar-файл будет запущен без открытия окна приложения и пользователь не будет видеть, запущено у него приложение или нет.
В текущей версии, часть проекта на Angular собирается вместе с отладочной информацией, чтобы облегчить выявление причин сбоев во время работы программы. За это отвечает вот этот участок `pom.xml`
```xml
ng
src/main/frontend
build
```
Для того, чтобы исключить отладочную информацию из Angular-сборки, измените вышеописанный блок кода на такой:
```xml
ng
src/main/frontend
build
--prod
```