diff --git a/README.md b/README.md index e39a4a6..3e90205 100644 --- a/README.md +++ b/README.md @@ -125,16 +125,20 @@ Or open a saved file and manually change the encoding to UTF8. ### 📈 How to view the report? -#### Online +#### Using website - go to the [website](https://assayo.online/); - click the “[Demo](https://assayo.online/demo)” button; - drop the `log.txt` file into the browser window; -#### Offline (NodeJS) +#### Use the library (NodeJS) - run `npx assayo` - open `./assayo/index.html` -#### Offline +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` +#### Use source code - download this repository `git clone https://github.com/bakhirev/assayo.git`; - drop the `log.txt` file to the `/build` folder; - run `/build/index.html`; diff --git a/documents/DE.md b/documents/DE.md index 4e613f4..6b3030e 100644 --- a/documents/DE.md +++ b/documents/DE.md @@ -31,35 +31,36 @@ Visualisierung und analyse ihrer Git-datenbank ([demo](https://assayo.online/dem ### Table of contents - [Wie kann ich die anzahl der commits schnell sehen?](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [Wie kann ich autoren zusammenbringen?](#link-6) - [Wie kann ich daten aus git?](#link-7) - [Für die onlineansicht](#link-8) - [Zum surfen ohne internet](#link-9) - [If you use PowerShell in Windows](#link-10) - [Wie kann ich den bericht sehen?](#link-11) - - [Online](#link-12) - - [Offline ](#link-13) - - [Offline](#link-14) -- [Wie kann ich die berichtsdatei neu erstellen?](#link-15) -- [Wie kann ich den bericht zur microservices-gruppe anzeigen?](#link-16) -- [Wie kann ich die benutzeroberfläche in ihren markenfarben neu streichen?](#link-17) -- [Wie signiere ich commits?](#link-18) -- [How to add checking for commit message?](#link-19) - - [ Use file commit-msg](#link-20) - - [ Use package pre-commit](#link-21) -- [Wie kann ich die datenerfassung automatisieren?](#link-22) - - [With backend](#link-23) - - [Kein bekend](#link-24) -- [DevOps ](#link-25) - - [Öffentlicher server](#link-26) - - [Privater server](#link-27) - - [Aktualisieren eines Docker-Images](#link-28) -- [️ About application](#link-29) - - [Architecture](#link-30) - - [Veröffentlichungen, ungefähr alle sechs monate. Was weiter:](#link-31) - - [Wie kann ich eine übersetzung hinzufügen oder bearbeiten?](#link-32) - - [Wünsche, Anregungen, Kommentare](#link-33) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [Wie kann ich die berichtsdatei neu erstellen?](#link-16) +- [Wie kann ich den bericht zur microservices-gruppe anzeigen?](#link-17) +- [Wie kann ich die benutzeroberfläche in ihren markenfarben neu streichen?](#link-18) +- [Wie signiere ich commits?](#link-19) +- [How to add checking for commit message?](#link-20) + - [ Use file commit-msg](#link-21) + - [ Use package pre-commit](#link-22) +- [Wie kann ich die datenerfassung automatisieren?](#link-23) + - [With backend](#link-24) + - [Kein bekend](#link-25) +- [DevOps ](#link-26) + - [Öffentlicher server](#link-27) + - [Privater server](#link-28) + - [Aktualisieren eines Docker-Images](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [Veröffentlichungen, ungefähr alle sechs monate. Was weiter:](#link-32) + - [Wie kann ich eine übersetzung hinzufügen oder bearbeiten?](#link-33) + - [Wünsche, Anregungen, Kommentare](#link-34) ### 🚀 Wie kann ich die anzahl der commits schnell sehen? In der wurzelverzeichnis ihres projektes muss der befehl ausgeführt werden: @@ -67,11 +68,16 @@ In der wurzelverzeichnis ihres projektes muss der befehl ausgeführt werden: git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report @@ -111,41 +117,46 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 Wie kann ich den bericht sehen? +### Wie kann ich den bericht sehen? -#### Online +#### 📈 Using website - gehe zu [Webseite](https://assayo.online/) - den knopf drücken “[Demonstration](https://assayo.online/demo?lang=ru)” - datei ziehen `log.txt` in das Browserfenster -#### Offline (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` -#### Offline +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` + +#### Use source code - laden sie dieses repository herunter - datei ziehen `log.txt` in den ordner`/build` - starten `/build/index.html` - oder ziehen sie einen ordner `/build` zu sich ins repository (der ort, an dem es liegt `log.txt`). Sie können den namen ändern. zum beispiel mit dem namen `/build` auf den namen `/report` Es ist wichtig, dass die log.txt datei vom befehl für die offlineansicht erstellt wird. - + ### 🏭 Wie kann ich die berichtsdatei neu erstellen? - Laden sie dieses repository herunter - Erfüllen `npm install` - Erfüllen `npm run build:local` - Der neue build wird im ordner sein `/build` - + ### 🗃️ Wie kann ich den bericht zur microservices-gruppe anzeigen? - Datei für jeden microservice generieren `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` usw.) - Siehe “Wie kann ich den bericht mit internet ansehen?”. Im letzten schritt ziehen sie alle dateien gleichzeitig in das browserfenster. - Siehe “Wie kann man den bericht ohne internet ansehen?” Im zweiten schritt ziehen sie die microservice-dateien alle (`log-1.txt`, `log-2.txt`, `log-3.txt` usw.) in den berichtsordner (`/build`). - + ### 🎨 Wie kann ich die benutzeroberfläche in ihren markenfarben neu streichen? Sie können ihr skin für die schnittstelle schreiben. Kann geändert werden: - **Überschrift**. Sie können es im URL-parameter angeben ```title```. Zum beispiel: ```?title=you company``` - **CSS stile**. Um dies zu tun, müssen sie die CSS-datei vorbereiten und ihre adresse im URL-parameter angeben ```theme```. Zum beispiel: ```?theme=//company.com/some.css```. Sie können klassennamen als selektoren verwenden. Die meisten von ihnen ändern sich nicht, wenn eine neue version veröffentlicht wird. - **Sprache**. Sie können es im URL-parameter angeben ```lang```. Zum Beispiel: ```?lang=es``` - + ### 📝 Wie signiere ich commits? Folge der praxis [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). Zum beispiel: ``` @@ -155,9 +166,9 @@ JIRA-1234 feat(profile): added avatar for user - art der arbeit `(feat, fix, style, refactor, test, doc usw.)` - arbeitsbereich `(profile - ein abschnitt der website, eine seite oder eine neue funktionalität, mit einem wort)` - beschreibung der arbeit `(added avatar for user)` - -### 👮 How to add checking for commit message? +### 👮 How to add checking for commit message? + #### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: @@ -168,7 +179,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -180,27 +191,27 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 📚 Wie kann ich die datenerfassung automatisieren? +### 📚 Wie kann ich die datenerfassung automatisieren? + #### With backend - use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### Kein bekend - erstellen sie einen klon ihres repositorys; - kopieren sie den ordner `build` aus dem aktuellen repository; - öffnen `build/index.html` im browser und zu lesezeichen hinzufügen; - fügen sie eine verknüpfung hinzu `build/assets/ci-cd.sh` in den startordner (windows); Jedes mal, wenn der computer neu gestartet wird, aktualisiert das skript die statistiken für alle daten, die automatisch in den hauptzweig aufgenommen wurden. - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### Öffentlicher server Sie können eine datendatei zum erstellen eines berichts auf eine öffentliche URL hochladen. Sie können die Website verwenden, um sie zu visualisieren [assayo](https://assayo.online/). Geben sie im URL-parameter die adresse an, an der die daten liegen ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### Privater server - herunterladen [docker das bild](https://hub.docker.com/r/bakhirev/assayo); - führen Sie es im lokalen netzwerk aus; @@ -211,30 +222,30 @@ assayo_url - die adresse des assayo-containers, er hört auf port 80; you_url - URL die adresse ihres containers mit git-logs; ``` Standardmäßig wird das abbild an der folgenden adresse ausgeführt ```http://127.0.0.1:80/```. Wenn es nicht funktioniert, überprüfen sie, ob der port 80 frei ist. - + #### Aktualisieren eines Docker-Images - befehl ausführen ```npm run build:docker``` - befehl ausführen ```docker build -t assayo .``` - ergebnis überprüfen ```docker run --name assayo -p 80:80 -d assayo```; - befehl ausführen ```docker tag assayo bakhirev/assayo:latest```; - senden sie ein containerimage an Docker Hub ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ About application +### 🛠️ ️ About application + #### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - + #### 🈯 Veröffentlichungen, ungefähr alle sechs monate. Was weiter: Schau [haupt dokumentation](https://github.com/bakhirev/assayo/blob/main/documents/RU.md) - + #### 🗺️ Wie kann ich eine übersetzung hinzufügen oder bearbeiten? Sie können eine neue übersetzung hinzufügen oder die aktuelle im abschnitt korrigieren ```ts/translations/```. [Anleitung](https://github.com/firstcontributions/first-contributions) - + #### 📧 Wünsche, Anregungen, Kommentare - telegramm [@bakhirev](https://t.me/bakhirev) (vorrangiger kommunikationsweg) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) diff --git a/documents/EN.md b/documents/EN.md index 3504507..782bb3b 100644 --- a/documents/EN.md +++ b/documents/EN.md @@ -32,35 +32,36 @@ Visualization and analysis of git commit statistics. Team Lead performance tool. ### Table of contents - [How to quickly view the number of commits?](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [How to concat authors?](#link-6) - [How to export data from git?](#link-7) - [For online viewing](#link-8) - [For offline viewing](#link-9) - [If you use PowerShell in Windows](#link-10) - [How to view the report?](#link-11) - - [Online](#link-12) - - [Offline ](#link-13) - - [Offline](#link-14) -- [How to rebuild the HTML report from source code?](#link-15) -- [How to view a report on a group of microservices?](#link-16) -- [How to brand the interface?](#link-17) -- [How to sign commits?](#link-18) -- [How to add checking for commit message?](#link-19) - - [Use file commit-msg](#link-20) - - [Use package pre-commit](#link-21) -- [How to automate data collection?](#link-22) - - [With backend](#link-23) - - [Without backend](#link-24) -- [DevOps ](#link-25) - - [Public server](#link-26) - - [Private server](#link-27) - - [How to update the Docker image?](#link-28) -- [️ About application](#link-29) - - [Architecture](#link-30) - - [How to add or edit a translation?](#link-31) - - [RoadMap:](#link-32) - - [Feedback, comments](#link-33) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [How to rebuild the HTML report from source code?](#link-16) +- [How to view a report on a group of microservices?](#link-17) +- [How to brand the interface?](#link-18) +- [How to sign commits?](#link-19) +- [How to add checking for commit message?](#link-20) + - [Use file commit-msg](#link-21) + - [Use package pre-commit](#link-22) +- [How to automate data collection?](#link-23) + - [With backend](#link-24) + - [Without backend](#link-25) +- [DevOps ](#link-26) + - [Public server](#link-27) + - [Private server](#link-28) + - [How to update the Docker image?](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [How to add or edit a translation?](#link-32) + - [RoadMap:](#link-33) + - [Feedback, comments](#link-34) ### 🚀 How to quickly view the number of commits? In the root directory of your project, run: @@ -68,17 +69,22 @@ In the root directory of your project, run: git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report ./assayo/log.txt - information from git ``` -If you do not have NodeJS , see the items "How to download data from git?" and "How to view the report?" +If you do not have NodeJS/PHP , see the items "How to download data from git?" and "How to view the report?" ### ‍🎭 How to concat authors? In the root directory of your project, you need to create a `.mailmap` file. @@ -112,41 +118,46 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 How to view the report? +### How to view the report? -#### Online +#### 📈 Using website - go to the [website](https://assayo.online/); - click the “[Demo](https://assayo.online/demo?ref=github&lang=en)” button; - drop the `log.txt` file into the browser window; -#### Offline (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` -#### Offline +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` + +#### Use source code - download this repository `git clone https://github.com/bakhirev/assayo.git`; - drop the `log.txt` file to the `/build` folder; - run `/build/index.html`; - or drop the `/build` folder to your repository (where the `log.txt` is located). You can change the name. For example, from `/build` to `/report`. In this case, it is important that the `log.txt` file is generated by the command for offline viewing. - + ### 🏭 How to rebuild the HTML report from source code? - download this repository `git clone https://github.com/bakhirev/assayo.git` - run `npm install` - run `npm run build:local` - the new HTML build will be in the `/build` folder - + ### 🗃️ How to view a report on a group of microservices? - generate for each microservice file `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` and etc.) You can do this manually, or use the [Assayo Crawler](https://github.com/bakhirev/assayo-crawler) module for automatic log collection; - see “How to view an online report?”. At the last step, drag all the files at once into the browser window. - see “How to see a report offline?”. At the second step, drag all microservice files (`log-1.txt`, `log-2.txt`, `log-3.txt` and etc.) to the report folder (`/build`). - + ### 🎨 How to brand the interface? You can create your own interface theme. Options: - **Title**. You can set default document title in the URL parameter ```title```. Example: ```?title=You Company``` - **Visual theme**. To do this, you need to prepare a CSS file with new styles and specify its URL in the ```theme``` parameter. Example: ```?theme=//company.com/some.css```. You can use class names as selectors. Most of them do not change in new versions. - **Language**. You can set language in the URL parameter ```lang```. Example: ```?lang=es``` - + ### 📝 How to sign commits? Follow the [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). Example: ``` @@ -156,9 +167,9 @@ JIRA-1234 feat(profile): Added avatar for user - type of work `(feat, fix, style, refactor, test, doc и т.д.)` - feature `(profile - new page on site or new function, use one (two) short wordor an abbreviation)` - what problem were solved `(Added avatar for user)` - -### 👮 How to add checking for commit message? +### 👮 How to add checking for commit message? + #### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: @@ -169,7 +180,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -181,27 +192,27 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 📚 How to automate data collection? +### 📚 How to automate data collection? + #### With backend - use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### Without backend - create a clone of the repository you need; - copy the `build` folder to the root; - open `build/index.html` in the browser and add it to bookmarks; - add a shortcut to `build/assets/ci-cd.sh` to the startup folder (Windows); Every time you restart the computer, the script will update statistics on all the data that automatically merged into the main branch. - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### Public server You can upload the data file for report construction to a public URL. And use the website’s [assayo](https://assayo.online/?ref=github&lang=en) to visualize it. ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### Private server - download the [docker image](https://hub.docker.com/r/bakhirev/assayo); - run it on your local network; @@ -212,27 +223,27 @@ assayo_url - URL of the assayo container, it listens on port 80; you_url - URL of your container with git logs; ``` By default, the image will run at ```http://127.0.0.1:80/```. If it doesn't work, check if port 80 is free. - + #### How to update the Docker image? - run ```npm run build:docker``` - run ```docker build -t assayo .``` - visually check the image ```docker run --name assayo -p 80:80 -d assayo```; - add tag ```docker tag assayo bakhirev/assayo:latest```; - push image to [Docker Hub](https://hub.docker.com/r/bakhirev/assayo) ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ About application +### 🛠️ ️ About application + #### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - + #### 🈯 How to add or edit a translation? You can add a new translation or correct an existing one in the ```ts/translations/``` folder. [Instruction](https://github.com/firstcontributions/first-contributions) - + #### 🗺️ RoadMap: Releases are planned approximately once every six months. What’s next: - more recommendations and achievements; @@ -241,10 +252,10 @@ Releases are planned approximately once every six months. What’s next: - file analysis; - different roles for statistics (hiding finances); - development of the backend, integration with other systems; - + #### 📧 Feedback, comments -- telegramm [@bakhirev](https://t.me/bakhirev) (priority method of communication) -- [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) -- website [https://assayo.online/](https://assayo.online/?ref=github&lang=en) +- 📱 [https://t.me/bakhirev](https://t.me/bakhirev) (priority method of communication) +- 📧 [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) +- 🌐 [https://assayo.online/](https://assayo.online/?ref=github&lang=en) diff --git a/documents/ES.md b/documents/ES.md index 95153af..d63f26c 100644 --- a/documents/ES.md +++ b/documents/ES.md @@ -32,35 +32,36 @@ Visualización y análisis de los datos de su repositorio git. ([demo](https://a ### Table of contents - [Cómo puedo rápidamente ver el número de commits?](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [Cómo combinar a los autores?](#link-6) - [Cómo descargar los datos desde git?](#link-7) - [Para la visualización en línea](#link-8) - [Para ver sin conexión](#link-9) - [If you use PowerShell in Windows](#link-10) - [¿Cómo ver el informe?](#link-11) - - [Online](#link-12) - - [Offline ](#link-13) - - [Offline](#link-14) -- [Como recompilar el build de un informe?](#link-15) -- [Como mirar el reporte de un grupo de microservicios?](#link-16) -- [¿Cómo puedo personalizar la interfaz de usuario?](#link-17) -- [¿Cómo firmar los commits?](#link-18) -- [How to add checking for commit message?](#link-19) - - [ Use file commit-msg](#link-20) - - [ Use package pre-commit](#link-21) -- [¿Cómo automatizar el recolección de datos?](#link-22) - - [With backend](#link-23) - - [Sin backend](#link-24) -- [DevOps ](#link-25) - - [Servidor público](#link-26) - - [Servidor privado](#link-27) - - [Actualización de la imagen Docker](#link-28) -- [️ About application](#link-29) - - [Architecture](#link-30) - - [Los lanzamientos son aproximadamente una vez cada seis meses. Lo siguiente será:](#link-31) - - [¿Cómo añadir o editar una traducción?](#link-32) - - [Deseos, comentarios](#link-33) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [Como recompilar el build de un informe?](#link-16) +- [Como mirar el reporte de un grupo de microservicios?](#link-17) +- [¿Cómo puedo personalizar la interfaz de usuario?](#link-18) +- [¿Cómo firmar los commits?](#link-19) +- [How to add checking for commit message?](#link-20) + - [ Use file commit-msg](#link-21) + - [ Use package pre-commit](#link-22) +- [¿Cómo automatizar el recolección de datos?](#link-23) + - [With backend](#link-24) + - [Sin backend](#link-25) +- [DevOps ](#link-26) + - [Servidor público](#link-27) + - [Servidor privado](#link-28) + - [Actualización de la imagen Docker](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [Los lanzamientos son aproximadamente una vez cada seis meses. Lo siguiente será:](#link-32) + - [¿Cómo añadir o editar una traducción?](#link-33) + - [Deseos, comentarios](#link-34) ### 🚀 Cómo puedo rápidamente ver el número de commits? En la carpeta raíz de su proyecto, ejecute: @@ -68,11 +69,16 @@ En la carpeta raíz de su proyecto, ejecute: git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report @@ -112,41 +118,46 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 ¿Cómo ver el informe? +### ¿Cómo ver el informe? -#### Online -- Ir a [sitio web](https://assayo.online/) -- Pulse el botón [Demo](https://assayo.online/demo?ref=github&lang=es)» -- Arrastrar y soltar archivo `log.txt` en la ventana del navegador +#### 📈 Using website +- ir a [sitio web](https://assayo.online/) +- pulse el botón [Demo](https://assayo.online/demo?ref=github&lang=es)» +- arrastrar y soltar archivo `log.txt` en la ventana del navegador -#### Offline (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` -#### Offline -- Descargar este repositorio -- Arrastrar y soltar archivo `log.txt` en la carpeta `/build` -- Lanzar `/build/index.html` -- O arrastrar una carpeta `/build` a su repositorio (donde se encuentra ' log.txt`). Puede cambiar el nombre. Por ejemplo `/build` contra `/report` -En este caso, es importante que el archivo ' log.txt ' fue generado por el equipo para ver sin conexión. +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` +#### Use source code +- descargar este repositorio +- arrastrar y soltar archivo `log.txt` en la carpeta `/build` +- lanzar `/build/index.html` +- o arrastrar una carpeta `/build` a su repositorio (donde se encuentra ' log.txt`). Puede cambiar el nombre. Por ejemplo `/build` contra `/report` +En este caso, es importante que el archivo ' log.txt ' fue generado por el equipo para ver sin conexión. + ### 🏭 Como recompilar el build de un informe? - Descargar este repositorio - Ejecutar `npm install` - Ejecutar `npm run build:local` - La nueva compilación estará en el directorio `/build` - + ### 🗃️ Como mirar el reporte de un grupo de microservicios? - Generar para cada microservicio el archivo `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` etc.) - Ver “Cómo ver el informe en línea?”. En el último paso, arrastrar todos los archivos al navegador. - Ver “Cómo ver informe fuera de línea?”. En el segundo paso, arrastrar los archivos de todos los microservicios al navegador (`log-1.txt`, `log-2.txt`, `log-3.txt` etc.) la carpeta informe (`/build`). - + ### 🎨 ¿Cómo puedo personalizar la interfaz de usuario? Puedes crear tu propio tema para la interfaz. Puedes cambiar: - **El título**. Puedes especificarlo en el parámetro de la URL ```title```. Por ejemplo: ```?title=You Company``` - **El tema visual**. Para esto, debes preparar un archivo CSS con los nuevos estilos y especificar su dirección en el parámetro de URL ```theme```. Por ejemplo: ```?theme=//company.com/some.css```. Puedes usar los nombres de clases como selectores. La mayoría de ellos no cambia con el lanzamiento de nuevas versiones. - **La lengua**. Puedes especificarla en el parámetro de la URL ```lang```. Por ejemplo: ```?lang=es``` - + ### 📝 ¿Cómo firmar los commits? Siga la práctica [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). Por ejemplo: ``` @@ -156,9 +167,9 @@ JIRA-1234 feat(profile): Added avatar for user - tipo de trabajo `(feat, fix, style, refactor, test, doc etc.)` - ficha `(profile - La sección del sitio, la página o la nueva funcionalidad, en una palabra)` - ¿qué problema resolvieron? `(Added avatar for user)` - -### 👮 How to add checking for commit message? +### 👮 How to add checking for commit message? + #### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: @@ -169,7 +180,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -181,12 +192,12 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 📚 ¿Cómo automatizar el recolección de datos? +### 📚 ¿Cómo automatizar el recolección de datos? + #### With backend - use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### Sin backend - clone del repositorio que desea; - copiar a la carpeta raíz `build`; @@ -194,15 +205,15 @@ fi - agregue un icono de `build/assets/ci-cd.sh` a su carpeta de inicio automático (Windows); Cada vez que reinicie su computadora, el script actualizará la estadística de todos los datos que se hayan incorporado automáticamente a la rama principal. - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### Servidor público Puede publicar el archivo con los datos para generar el informe en una URL pública. Para visualizarlo, puede usar la interfaz web del sitio [assayo](https://assayo.online/). Simplemente indique la dirección donde están los datos en el parámetro URL ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### Servidor privado - descargar [docker образ](https://hub.docker.com/r/bakhirev/assayo); - recogerlo en la red local; @@ -213,23 +224,23 @@ assayo_url - URL dirección del contenedor assayo, Él está escuchando el puert you_url - URL la dirección de su contenedor con registros git; ``` Por defecto, la imagen se ejecutará en la siguiente dirección ```http://127.0.0.1:80/```. Si no funciona, compruebe si tiene el puerto 80 disponible - + #### Actualización de la imagen Docker - construir ```npm run build:docker``` - montar la imagen ```docker build -t assayo .``` - comprobar visualmente la imagen ```docker run --name assayo -p 80:80 -d assayo```; - poner la etiqueta ```docker tag assayo bakhirev/assayo:latest```; - poner la imagen en Docker Hub ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ About application +### 🛠️ ️ About application + #### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - + #### 🈯 Los lanzamientos son aproximadamente una vez cada seis meses. Lo siguiente será: - más consejos y logros; - resultados del año / mes, impresión de informes; @@ -237,11 +248,11 @@ Por defecto, la imagen se ejecutará en la siguiente dirección ```http://127.0. - análisis de archivos; - diferentes roles para estadísticas (ocultación de finanzas); - desarrollo de la parte de atrás, integraciones con otros sistemas; - + #### 🗺️ ¿Cómo añadir o editar una traducción? Puede agregar una nueva traducción o corregir la actual en la sección ```ts/translations/```. [Instrucciones](https://github.com/firstcontributions/first-contributions) - + #### 📧 Deseos, comentarios - telegramm [@bakhirev](https://t.me/bakhirev) (La forma preferencial de contacto) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) diff --git a/documents/FR.md b/documents/FR.md index 0235cf6..b483ab2 100644 --- a/documents/FR.md +++ b/documents/FR.md @@ -32,35 +32,36 @@ Visualisation et analyse des données de votre dépôt Git ([demo](https://assay ### Table of contents - [De combien de commits avez-vous besoin?](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [Comment pouvez-vous combiner les auteurs ?](#link-6) - [Comment télécharger des données depuis git ?](#link-7) - [Pour une visualisation en ligne](#link-8) - [Pour la navigation hors ligne](#link-9) - [If you use PowerShell in Windows](#link-10) - [Comment voir le rapport en ligne?](#link-11) - - [Online](#link-12) - - [Offline ](#link-13) - - [Offline](#link-14) -- [Comment recompiler la build du rapport?](#link-15) -- [Comment voir le compte rendu pour un groupe de microservices?](#link-16) -- [Comment apposer une marque sur l’interface?](#link-17) -- [Comment signer les commits ?](#link-18) -- [How to add checking for commit message?](#link-19) - - [ Use file commit-msg](#link-20) - - [ Use package pre-commit](#link-21) -- [Comment automatiser la collecte de données?](#link-22) - - [With backend](#link-23) - - [Sans back-end](#link-24) -- [DevOps ](#link-25) - - [Serveur public](#link-26) - - [Serveur privé](#link-27) - - [Mise à jour de l’image-Docker](#link-28) -- [️ About application](#link-29) - - [Architecture](#link-30) - - [Les versions sont publiées environ tous les six mois. Quoi de neuf:](#link-31) - - [Comment ajouter ou modifier une traduction?](#link-32) - - [Souhaits, suggestions, commentaires](#link-33) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [Comment recompiler la build du rapport?](#link-16) +- [Comment voir le compte rendu pour un groupe de microservices?](#link-17) +- [Comment apposer une marque sur l’interface?](#link-18) +- [Comment signer les commits ?](#link-19) +- [How to add checking for commit message?](#link-20) + - [ Use file commit-msg](#link-21) + - [ Use package pre-commit](#link-22) +- [Comment automatiser la collecte de données?](#link-23) + - [With backend](#link-24) + - [Sans back-end](#link-25) +- [DevOps ](#link-26) + - [Serveur public](#link-27) + - [Serveur privé](#link-28) + - [Mise à jour de l’image-Docker](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [Les versions sont publiées environ tous les six mois. Quoi de neuf:](#link-32) + - [Comment ajouter ou modifier une traduction?](#link-33) + - [Souhaits, suggestions, commentaires](#link-34) ### 🚀 De combien de commits avez-vous besoin? Dans le répertoire racine de votre projet, exécutez les commandes suivantes: @@ -68,11 +69,16 @@ Dans le répertoire racine de votre projet, exécutez les commandes suivantes: git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report @@ -112,40 +118,45 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 Comment voir le rapport en ligne? +### Comment voir le rapport en ligne? -#### Online +#### 📈 Using website - Aller à [сайт](https://assayo.online/) - Appuyer sur le bouton “[Démo](https://assayo.online/demo?ref=github&lang=fr)” - Faites glisser le fichier `log.txt` dans la fenêtre du navigateur -#### Offline (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` -#### Offline +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` + +#### Use source code - Télécharger ce dépôt - Glisser le fichier `log.txt` dans le dossier `/build` - Démarrer `/build/index.html` - Ou coller le dossier `/build` Sur votre dépôt (là où se trouve `log.txt`). Vous pouvez changer le nom. Par exemple avec `/build` sur `/report`. Dans cette cas, il est important que le fichier log.txt ait été généré par le commande pour la visualisation hors ligne. - + ### 🏭 Comment recompiler la build du rapport? - Télécharger ce dépôt - Exécuter `npm install` - Exécuter `npm run build:local` - La dernière build sera dans le dossier `/build` - + ### 🗃️ Comment voir le compte rendu pour un groupe de microservices? - générer un fichier pour chaque microservice `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` etc.) - Voir “Comment voir le rapport en ligne?”. Au dernier pas, glisser tous les fichiers dans la fenêtre du navigateur. - Voir “Comment regarder le rapport hors-ligne?”. Au deuxième pas, coller tous les fichier de microservices (`log-1.txt`, `log-2.txt`, `log-3.txt` etc.) dans le dossier du rapport (`/build`). - + ### 🎨 Comment apposer une marque sur l’interface? Vous pouvez écrire votre propre thème pour l’interface. Vous pouvez changer : - **En-tête**. Vous pouvez le spécifier dans le paramètre de l’URL ```title```. Par exemple: ```?title=You Company``` - **Thème visuel**.Pour cela, vous devez préparer un fichier CSS avec de nouveaux styles et indiquer son adresse dans le paramètre de l’URL ```theme```. Par exemple: ```?theme=//company.com/some.css```. Vous pouvez utiliser les noms de classes comme sélecteurs. La plupart d’entre elles ne changent pas lors de la sortie de nouvelles versions. - **Langue**. Vous pouvez l’indiquer dans le paramètre d’URL ```lang```. Par exemple: ```?lang=es``` - + ### 📝 Comment signer les commits ? Suivez la pratique [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). Par exemple: ``` @@ -155,9 +166,9 @@ JIRA-1234 feat(profile): Added avatar for user - type de travail `(feat, fix, style, refactor, test, doc etc.)` - ficha `(profile - la section du site, la page ou la nouvelle fonctionnalité, en un mot)` - quel problème ont-ils résolu `(Added avatar for user)` - -### 👮 How to add checking for commit message? +### 👮 How to add checking for commit message? + #### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: @@ -168,7 +179,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -180,26 +191,26 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 📚 Comment automatiser la collecte de données? +### 📚 Comment automatiser la collecte de données? + #### With backend - use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### Sans back-end - clonez le dépôt que vous voulez ; - copiez le dossier `build`; - Ouvrez `build/index.html` dans le navigateur et ajoutez-le aux favoris; - ajoutez un raccourci sur `build/assets/ci-cd.sh` dans le dossier de démarrage automatique (Windows); Chaque fois que votre ordinateur se recharge, le script mettra à jour les statistiques sur toutes les données qui se sont automatiquement insérées dans la branche principale. - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### Serveur public Vous pouvez mettre à disposition le fichier avec les données pour construire le rapport sur l’URL publique. Et pour sa visualisation, utiliser l’interface web du site. [assayo](https://assayo.online/). Tout simplement, indiquez l’adresse où se trouvent les données dans le paramètre de l’URL ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### Serveur privé - télécharger [docker образ](https://hub.docker.com/r/bakhirev/assayo); - Soulevez-le sur le réseau local; @@ -210,23 +221,23 @@ assayo_url - URL Conteneur assayo, écoute le port 80; you_url - URL адресс Adresse de votre conteneur de logs git; ``` Par défaut, l'image s'exécute à ```http://127.0.0.1:80/```. Si cela ne fonctionne pas, vérifiez si le port 80 est disponible. - + #### Mise à jour de l’image-Docker - constuire la build ```npm run build:docker``` - assembler l'image ```docker build -t assayo .``` - vérifier visuellement l'image ```docker run --name assayo -p 80:80 -d assayo```; - mettre la balise ```docker tag assayo bakhirev/assayo:latest```; - Envoyer le code au référentiel d'images dans Docker Hub ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ About application +### 🛠️ ️ About application + #### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - + #### 🈯 Les versions sont publiées environ tous les six mois. Quoi de neuf: - plus de conseils et de succès; - résultats de l’année / du mois, impression des rapports; @@ -234,11 +245,11 @@ Par défaut, l'image s'exécute à ```http://127.0.0.1:80/```. Si cela ne foncti - analyse des fichiers; - différents rôles pour la statistique (cacher la finance); - développement du backend, intégrations avec d’autres systèmes; - + #### 🗺️ Comment ajouter ou modifier une traduction? Vous pouvez ajouter une nouvelle traduction ou corriger la traduction existante dans le section ```ts/translations/```. [Instruction](https://github.com/firstcontributions/first-contributions) - + #### 📧 Souhaits, suggestions, commentaires - telegramm [@bakhirev](https://t.me/bakhirev) (voie de communication prioritaire) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) diff --git a/documents/JA.md b/documents/JA.md index 547ee64..95ab6f6 100644 --- a/documents/JA.md +++ b/documents/JA.md @@ -32,35 +32,36 @@ ### Table of contents - [コミット数を素早く確認するにはどうすればよいでしょうか。](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [作者をまとめるにはどうすればいいですか？](#link-6) - [Gitからデータをダウンロードするにはどうすればよろしいでしょうか。](#link-7) - [Дオンラインで見るため](#link-8) - [インターネットなしで見るために](#link-9) - [If you use PowerShell in Windows](#link-10) - [レポートを表示するにはどうすればよいですか？ ](#link-11) - - [Online](#link-12) - - [Offline ](#link-13) - - [Offline](#link-14) -- [レポートファイルを再構成する方法は？](#link-15) -- [マイクロサービス群のレポートを表示するにはどうすればよいでしょうか。](#link-16) -- [自社のブランドカラーでインターフェースをリニュアルカラーに変えるにはどうすればよろしいでしょうか。](#link-17) -- [commit文の署名方法は？](#link-18) -- [How to add checking for commit message?](#link-19) - - [ Use file commit-msg](#link-20) - - [ Use package pre-commit](#link-21) -- [データの自動収集方法は？](#link-22) - - [With backend](#link-23) - - [バックエンドなし](#link-24) -- [DevOps ](#link-25) - - [公開サーバ](#link-26) - - [プライベートサーバー](#link-27) - - [Dockerイメージの更新](#link-28) -- [️ About application](#link-29) - - [Architecture](#link-30) - - [半年ごとにリリースを行います。次は何でしょうか。](#link-31) - - [翻訳を追加または編集するにはどうすればいいでしょうか。](#link-32) - - [願い、提案、コメント](#link-33) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [レポートファイルを再構成する方法は？](#link-16) +- [マイクロサービス群のレポートを表示するにはどうすればよいでしょうか。](#link-17) +- [自社のブランドカラーでインターフェースをリニュアルカラーに変えるにはどうすればよろしいでしょうか。](#link-18) +- [commit文の署名方法は？](#link-19) +- [How to add checking for commit message?](#link-20) + - [ Use file commit-msg](#link-21) + - [ Use package pre-commit](#link-22) +- [データの自動収集方法は？](#link-23) + - [With backend](#link-24) + - [バックエンドなし](#link-25) +- [DevOps ](#link-26) + - [公開サーバ](#link-27) + - [プライベートサーバー](#link-28) + - [Dockerイメージの更新](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [半年ごとにリリースを行います。次は何でしょうか。](#link-32) + - [翻訳を追加または編集するにはどうすればいいでしょうか。](#link-33) + - [願い、提案、コメント](#link-34) ### 🚀 コミット数を素早く確認するにはどうすればよいでしょうか。 プロジェクトのルートディレクトリで以下のコマンドを実行します: @@ -68,11 +69,16 @@ git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report @@ -112,41 +118,46 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 レポートを表示するにはどうすればよいですか？ +### レポートを表示するにはどうすればよいですか？ -#### Online +#### 📈 Using website - に切り替える [ウェブサイト](https://assayo.online/) - ボタンを押す “[デモ](https://assayo.online/demo?lang=ru)” - ファイルをドラッグ＆ドロップする `log.txt` ブラウザウィンドウで -#### Offline (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` -#### Offline +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` + +#### Use source code - このリポジトリをダウンロードする - ファイルをドラッグ＆ドロップする `log.txt` フォルダへ `/build` - 実行するには `/build/index.html` - フォルダをドラッグして下さい `/build` 自分のリポジトリーにフォルダを置いてください (それがある場所 `log.txt`). 名前を変更することができます。例えば名前 `/build` を `/report` 重要なのは、ファイル `log.txt` インターネットが利用できない環境で、レポートを表示するために作成されたコマンドである必要があります。 - + ### 🏭 レポートファイルを再構成する方法は？ - このリポジトリをダウンロードしてください - 実行するには `npm install` - 実行するには `npm run build:local` - 最新のビルドは、フォルダに含まれるでしょう `/build` - + ### 🗃️ マイクロサービス群のレポートを表示するにはどうすればよいでしょうか。 - マイクロサービスごとにファイルを作成します。 `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` など。) - "インターネット上でレポートを見る方法"を参照してください。最後の手順では、すべてのファイルをブラウザのウィンドウに一度にドラッグ＆ドロップします。 - “インターネットなしでレポートを見る方法” を参照してください。第二段階では、マイクロサービスのすべてのファイルをドラッグしてドロップする必要があります。(`log-1.txt`, `log-2.txt`, `log-3.txt` など。) レポートフォルダへ (`/build`). - + ### 🎨 自社のブランドカラーでインターフェースをリニュアルカラーに変えるにはどうすればよろしいでしょうか。 インターフェースのテーマを独自に作成することができます。下記の項目は変更できます。 - **見出し**. それはURLパラメータで指定することができます ```title```. 例えば: ```?title=You Company``` - **CSS スタイル**. そのためにはCSSファイルを用意し、そのアドレスをURLパラメーターに指定する必要があります ```theme```. 例えば: ```?theme=//company.com/some.css```. クラス名をセレクターとして使用することができます。ほとんどの場合、新しいバージョンがリリースされると変更されません - **言語**. URLパラメータに指定することができます ```lang```. 例えば: ```?lang=es``` - + ### 📝 commit文の署名方法は？ 練習に従ってください [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). 例えば: ``` @@ -156,9 +167,9 @@ JIRA-1234 feat(profile): Added avatar for user - 仕事の種類 `(feat, fix, style, refactor, test, doc など。)` - 仕事の分野 `(profile - サイトのセクション、ページ、新機能、簡単に)` - ジョブの説明 `(Added avatar for user)` - -### 👮 How to add checking for commit message? +### 👮 How to add checking for commit message? + #### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: @@ -169,7 +180,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -181,27 +192,27 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 📚 データの自動収集方法は？ +### 📚 データの自動収集方法は？ + #### With backend - use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### バックエンドなし - リポジトリのクローンを作成します。; - フォルダをコピーする `build` 現在のリポジトリから; - オープン `build/index.html` ブラウザでブックマークに追加します。; - にショートカットを追加する `build/assets/ci-cd.sh` 自動起動フォルダーに (Windows); コンピューターを再起動するとき、スクリプトはメインブランチに自動的に挿入されたすべてのデータについての統計を更新します。 - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### 公開サーバ データをレポートビルド用に公開するファイルをURLで公開することができます。その視覚化は、サイト上で利用可能なツールを使用することで行うことができます。 [assayo](https://assayo.online/). データがある場所のアドレスを、URLパラメータに入力してください。 ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### プライベートサーバー - ダウンロード [dockerイメージ](https://hub.docker.com/r/bakhirev/assayo); - ローカルネットワーク内で実行します。; @@ -212,30 +223,30 @@ assayo_url - ポート80でリッスンしているassayoコンテナのURL; you_url - gitのログのコンテナーのURLアドレス; ``` デフォルトではイメージは以下のアドレスで起動します ```http://127.0.0.1:80/```. 問題が解決しない場合は、ポート80が開いているか確認してみてください。 - + #### Dockerイメージの更新 - 次のコマンドを実行します ```npm run build:docker``` - 次のコマンドを実行します ```docker build -t assayo .``` - 結果を確認する ```docker run --name assayo -p 80:80 -d assayo```; - 次のコマンドを実行します ```docker tag assayo bakhirev/assayo:latest```; - コンテナイメージをDocker Hubにアップロードする ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ About application +### 🛠️ ️ About application + #### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - + #### 🈯 半年ごとにリリースを行います。次は何でしょうか。 見て！ [主なドキュメント](https://github.com/bakhirev/assayo/blob/main/documents/RU.md) - + #### 🗺️ 翻訳を追加または編集するにはどうすればいいでしょうか。 新しい翻訳を追加するか、現在の翻訳を修正するために、以下のセクションでそれを行うことができます: ```ts/translations/```. [取扱説明書](https://github.com/firstcontributions/first-contributions) - + #### 📧 願い、提案、コメント - telegramm [@bakhirev](https://t.me/bakhirev) (優先通信方式) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) diff --git a/documents/PT.md b/documents/PT.md index dc44a9e..1bbfd4a 100644 --- a/documents/PT.md +++ b/documents/PT.md @@ -32,35 +32,36 @@ Visualização e análise de dados do seu repositório git ([demonstração](htt ### Table of contents - [Como é rápido ver o número de commits?](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [Como combinar os autores?](#link-6) - [Como exportar dados do git? ](#link-7) - [Para visualização online](#link-8) - [Para ver sem internet](#link-9) - [If you use PowerShell in Windows](#link-10) - [Como ver o relatório?](#link-11) - - [Online](#link-12) - - [Offline ](#link-13) - - [Offline](#link-14) -- [Como recompilar o arquivo do relatório?](#link-15) -- [Como visualizar o relatório do grupo de microserviços?](#link-16) -- [Como alterar as cores da interface para as cores da sua marca?](#link-17) -- [Como faço para assinar commits?](#link-18) -- [How to add checking for commit message?](#link-19) - - [ Use file commit-msg](#link-20) - - [ Use package pre-commit](#link-21) -- [Como automatizar a coleta de dados?](#link-22) - - [With backend](#link-23) - - [Sem backend](#link-24) -- [DevOps ](#link-25) - - [Servidor Público](#link-26) - - [Servidor Privado](#link-27) - - [Atualizar a imagem Docker](#link-28) -- [️ About application](#link-29) - - [Architecture](#link-30) - - [Liberações, aproximadamente, uma vez por semestre. O que vem a seguir:](#link-31) - - [Como adicionar ou editar uma tradução?](#link-32) - - [Sugestões, sugestões, comentários](#link-33) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [Como recompilar o arquivo do relatório?](#link-16) +- [Como visualizar o relatório do grupo de microserviços?](#link-17) +- [Como alterar as cores da interface para as cores da sua marca?](#link-18) +- [Como faço para assinar commits?](#link-19) +- [How to add checking for commit message?](#link-20) + - [ Use file commit-msg](#link-21) + - [ Use package pre-commit](#link-22) +- [Como automatizar a coleta de dados?](#link-23) + - [With backend](#link-24) + - [Sem backend](#link-25) +- [DevOps ](#link-26) + - [Servidor Público](#link-27) + - [Servidor Privado](#link-28) + - [Atualizar a imagem Docker](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [Liberações, aproximadamente, uma vez por semestre. O que vem a seguir:](#link-32) + - [Como adicionar ou editar uma tradução?](#link-33) + - [Sugestões, sugestões, comentários](#link-34) ### 🚀 Como é rápido ver o número de commits? No diretório raiz do seu projeto, execute o comando: @@ -68,11 +69,16 @@ No diretório raiz do seu projeto, execute o comando: git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report @@ -112,41 +118,46 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 Como ver o relatório? +### Como ver o relatório? -#### Online +#### 📈 Using website - Ir para [site](https://assayo.online/) - Pressione o botão “[Demonstração](https://assayo.online/demo?lang=ru)” - Arrastar e largar `log.txt` na janela do navegador -#### Offline (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` -#### Offline +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` + +#### Use source code - Baixar este repositório - Arraste o arquivo `log.txt` para a pasta `/build` - Lançar `/build/index.html` - Ou arraste a pasta `/build` ir para o repositório (o lugar onde se encontra `log.txt`). Você pode mudar o nome. Por exemplo, do nome `/build` no título `/report` É importante que o arquivo `log.txt` foi criado por uma equipe para navegar sem internet. - + ### 🏭 Como recompilar o arquivo do relatório? - Baixar este repositório - Executar `npm install` - Executar `npm run build:local` - A compilação mais recente estará na pasta `/build` - + ### 🗃️ Como visualizar o relatório do grupo de microserviços? - Gerar um arquivo para cada microserviço `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` etc.) - Veja “Como visualizar o relatório com a internet?”. No último passo, arraste todos os arquivos para a janela do navegador. - Veja “Como visualizar o relatório sem a internet?”. No segundo passo, arraste todos os microserviços (`log-1.txt`, `log-2.txt`, `log-3.txt` etc.) na pasta relatório (`/build`). - + ### 🎨 Como alterar as cores da interface para as cores da sua marca? Você pode escrever seu próprio tema de interface. Pode mudar: - **Cabeçalho**. Você pode especificar em um parâmetro da URL ```title```. Por exemplo: ```?title=You Company``` - **CSS стили**. Para fazer isso, você precisa preparar um arquivo CSS e especificar o seu endereço no parâmetro da URL ```theme```. Por exemplo: ```?theme=//company.com/some.css```. Você pode usar os nomes das classes como seletores. A maioria deles não muda na saída de uma nova versão. - **Idioma**. Você pode incluir em um parâmetro de URL. ```lang```. Por exemplo: ```?lang=es``` - + ### 📝 Como faço para assinar commits? Siga a prática [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). Por exemplo: ``` @@ -156,9 +167,9 @@ JIRA-1234 feat(profile): Added avatar for user - tipo de trabalho `(feat, fix, style, refactor, test, doc etc.)` - área de trabalho `(profile - Página)` - descrição do trabalho `(Added avatar for user)` - -### 👮 How to add checking for commit message? +### 👮 How to add checking for commit message? + #### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: @@ -169,7 +180,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -181,27 +192,27 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 📚 Como automatizar a coleta de dados? +### 📚 Como automatizar a coleta de dados? + #### With backend - use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### Sem backend - criar um clone do seu repositório; - copie a pasta `build` do repositório atual; - abrir `build/index.html` no navegador e adicionar aos favoritos; - adicionar um shortcut na `build/assets/ci-cd.sh` na pasta de inicialização (Windows); A cada reinício do computador, o script atualiza a estatística com todos os dados que sejam automaticamente incorporados na branch principal. - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### Servidor Público Você pode disponibilizar o arquivo com os dados para construção do relatório em um URL público. Para visualizá-lo, você pode usar um site [assayo](https://assayo.online/). Especifique o endereço onde os dados estão localizados no parâmetro de URL ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### Servidor Privado - baixar [docker imagem](https://hub.docker.com/r/bakhirev/assayo); - execute-o na rede local; @@ -212,30 +223,30 @@ assayo_url - O URL do endereço do container Assay, ele está escutando na porta you_url - O URL do seu container com os logs do git; ``` Por padrão, a imagem será iniciada no endereço ```http://127.0.0.1:80/```. Se você não conseguiu, verifique se a porta 80 está disponível no seu computador. - + #### Atualizar a imagem Docker - executar um comando ```npm run build:docker``` - executar um comando ```docker build -t assayo .``` - verificar o resultado ```docker run --name assayo -p 80:80 -d assayo```; - executar um comando ```docker tag assayo bakhirev/assayo:latest```; - enviar a imagem do container para o Docker Hub ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ About application +### 🛠️ ️ About application + #### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - + #### 🈯 Liberações, aproximadamente, uma vez por semestre. O que vem a seguir: Vide [documentação básica](https://github.com/bakhirev/assayo/blob/main/documents/RU.md) - + #### 🗺️ Como adicionar ou editar uma tradução? Você pode adicionar uma nova tradução ou corrigir uma existente na seção ```ts/translations/```. [Instrução](https://github.com/firstcontributions/first-contributions) - + #### 📧 Sugestões, sugestões, comentários - telegramm [@bakhirev](https://t.me/bakhirev) (método de comunicação prioritário) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) diff --git a/documents/RU.md b/documents/RU.md index e643d29..a361ef2 100644 --- a/documents/RU.md +++ b/documents/RU.md @@ -38,28 +38,29 @@ - [Для офлайн просмотра](#link-9) - [Если вы используете PowerShell в Windows](#link-10) - [Как посмотреть отчёт?](#link-11) - - [Онлайн](#link-12) - - [Офлайн ](#link-13) - - [Офлайн](#link-14) -- [Как пересобрать файл отчёта из исходного кода?](#link-15) -- [Как посмотреть отчёт по группе микросервисов?](#link-16) -- [Как брендировать интерфейс?](#link-17) -- [Как подписывать коммиты?](#link-18) -- [Как добавить проверку текста коммита?](#link-19) - - [Используя файл commit-msg](#link-20) - - [Используя пакет pre-commit](#link-21) -- [Как автоматизировать сбор данных?](#link-22) - - [С бекендом](#link-23) - - [Без бекенда](#link-24) -- [DevOps ](#link-25) - - [Публичный сервер](#link-26) - - [Приватный сервер](#link-27) - - [Обновление Docker-образа](#link-28) -- [️ О приложении](#link-29) - - [Архитектура](#link-30) - - [Релизы, примерно, раз в полгода. Что дальше:](#link-31) - - [Как добавить или отредактировать перевод?](#link-32) - - [Пожелания, предложения, замечания](#link-33) + - [Через сайт](#link-12) + - [Используя библиотеку ](#link-13) + - [Используя библиотеку ](#link-14) + - [Без установки библиотек](#link-15) +- [Как пересобрать файл отчёта из исходного кода?](#link-16) +- [Как посмотреть отчёт по группе микросервисов?](#link-17) +- [Как брендировать интерфейс?](#link-18) +- [Как подписывать коммиты?](#link-19) +- [Как добавить проверку текста коммита?](#link-20) + - [Используя файл commit-msg](#link-21) + - [Используя пакет pre-commit](#link-22) +- [Как автоматизировать сбор данных?](#link-23) + - [С бекендом](#link-24) + - [Без бекенда](#link-25) +- [DevOps ](#link-26) + - [Публичный сервер](#link-27) + - [Приватный сервер](#link-28) + - [Обновление Docker-образа](#link-29) +- [️ О приложении](#link-30) + - [Архитектура](#link-31) + - [Релизы, примерно, раз в полгода. Что дальше:](#link-32) + - [Как добавить или отредактировать перевод?](#link-33) + - [Пожелания, предложения, замечания](#link-34) ### 🚀 Как быстро посмотреть количество коммитов? В корневой директории вашего проекта выполнить: @@ -111,41 +112,46 @@ Git создаст файл `log.txt`. Он содержит данные для ``` Или откройте сохраненный файл и вручную измените кодировку на UTF-8. -### 📈 Как посмотреть отчёт? +### Как посмотреть отчёт? -#### Онлайн +#### 📈 Через сайт - Перейти на [сайт](https://assayo.online/) - Нажать кнопку «[Демо](https://assayo.online/demo?ref=github&lang=ru)» - Перетащить файл `log.txt` в окно браузера -#### Офлайн (с NodeJS) -- Выполнить `npx assayo` -- Открыть `./assayo/index.html` +#### Используя библиотеку (NodeJS) +- выполнить `npx assayo` +- открыть `./assayo/index.html` -#### Офлайн -- Скачать этот репозиторий -- Перетащить файл `log.txt` в папку `/build` -- Запустить `/build/index.html` -- Или перетащить папку `/build` к себе в репозиторий (туда, где лежит `log.txt`). Можно сменить название. Например с `/build` на `/report` -В этом случае важно, чтобы файл `log.txt` был сгенерирован командой для офлайн просмотра. +#### Используя библиотеку (PHP) +- выполнить `composer require bakhirev/assayo` +- выполнить `vendor/bin/assayo` +- открыть `./assayo/index.html` +#### Без установки библиотек +- скачать этот репозиторий +- перетащить файл `log.txt` в папку `/build` +- запустить `/build/index.html` +- или перетащить папку `/build` к себе в репозиторий (туда, где лежит `log.txt`). Можно сменить название. Например с `/build` на `/report` +В этом случае важно, чтобы файл `log.txt` был сгенерирован командой для офлайн просмотра. + ### 🏭 Как пересобрать файл отчёта из исходного кода? - Скачать этот репозиторий - Выполнить `npm install` - Выполнить `npm run build:local` - Свежая сборка будет в папке `/build` - + ### 🗃️ Как посмотреть отчёт по группе микросервисов? - Сгенерировать для каждого микросервиса файл `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` и т.д.). Вы можете сделать это в ручную, или использовать модуль [Assayo Crawler](https://github.com/bakhirev/assayo-crawler) для автоматического сбора логов; - См. «Как посмотреть отчёт онлайн?». На последнем шаге перетащить сразу все файлы в окно браузера. - См. «Как посмотреть отчёт офлайн?». На втором шаге перетащить все файлы микросервисов (`log-1.txt`, `log-2.txt`, `log-3.txt` и т.д.) в папку отчета (`/build`). - + ### 🎨 Как брендировать интерфейс? Вы можете написать свою тему для интерфейса. Можно менять: - **Заголовок**. Вы можете указать его в URL-параметре ```title```. Например: ```?title=You Company``` - **Визуальную тему**. Для этого нужно подготовить CSS файл с новыми стилями и указать его адрес в URL-параметре ```theme```. Например: ```?theme=//company.com/some.css```. Вы можете использовать имена классов в качестве селекторов. Большинство из них не меняется в при выходе новой версий. - **Язык**. Вы можете указать его в URL-параметре ```lang```. Например: ```?lang=es``` - + ### 📝 Как подписывать коммиты? Следуйте практике [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). Например: ``` @@ -155,9 +161,9 @@ JIRA-1234 feat(profile): Added avatar for user - тип работы `(feat, fix, style, refactor, test, doc и т.д.)` - фича `(profile - раздел сайта, страница или новый функционал, одним словом)` - какую проблему решали `(Added avatar for user)` - -### 👮 Как добавить проверку текста коммита? +### 👮 Как добавить проверку текста коммита? + #### Используя файл `commit-msg` 1. Создайте файл `commit-msg` в папке `.git/hooks/` 2. Добавьте в файл следующий текст: @@ -168,7 +174,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Используя пакет [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Добавьте в файл `package.json` блок `commit-msg`: ``` @@ -180,27 +186,27 @@ fi ... ``` 2. Выполните команду `npm install pre-commit` - -### 📚 Как автоматизировать сбор данных? +### 📚 Как автоматизировать сбор данных? + #### С бекендом - используйте модуль [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); - + #### Без бекенда - создайте клон нужного вам репозитория; - скопируйте в корень папку `build`; - откройте `build/index.html` в браузере и добавьте в закладки; - добавьте ярлык на `build/assets/ci-cd.sh` в папку автозагрузки (Windows); Каждый раз, при перезагрузке компьютера, скрипт будет обновлять статистику по всем данным, которые автоматически влились в основную ветку. - -### 🛠️ DevOps (CI/CD) +### 🛠️ DevOps (CI/CD) + #### Публичный сервер Вы можете выкладывать файл с данными для построения отчёта на публичный URL. А для его визуализации использовать веб-интерфейс сайта [assayo](https://assayo.online/). Просто укажите адресс, где лежат данные, в URL-параметре ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### Приватный сервер - скачайте [docker образ](https://hub.docker.com/r/bakhirev/assayo); - поднимите его в локальной сети; @@ -211,23 +217,23 @@ assayo_url - URL адресс контейнера assayo, он слушает 8 you_url - URL адресс вашего контейнера с логами git; ``` По умолчанию образ запустится по адресу ```http://127.0.0.1:80/```. Если не получилось проверьте свободен ли у вас 80 порт. - + #### Обновление Docker-образа - собрать билд ```npm run build:docker``` - собрать образ ```docker build -t assayo .``` - визуально проверить образ ```docker run --name assayo -p 80:80 -d assayo```; - поставить тег ```docker tag assayo bakhirev/assayo:latest```; - запушить образ в Docker Hub ```docker push bakhirev/assayo:latest```; - -### 🛠️ ️ О приложении +### 🛠️ ️ О приложении + #### 📐 Архитектура 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) отображение списка отчётов. Каждый отчёт имеет название, описание и список репозиториев. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) сборка, склейка, обработка логов из репозиториев для отчётов. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(вы тут)** отображение отчётов. Для работы ему нужен log файл с данными. - + #### 🈯 Релизы, примерно, раз в полгода. Что дальше: - больше советов и достижений; - итоги года / месяца, печать отчётов; @@ -235,11 +241,11 @@ you_url - URL адресс вашего контейнера с логами - анализ файлов; - разные роли для статистики (скрытие финансов); - разработка бекенда, интеграции с другими системами; - + #### 🗺️ Как добавить или отредактировать перевод? Вы можете добавить новый перевод или поправить текущий в разделе ```ts/translations/```. [Инструкция](https://github.com/firstcontributions/first-contributions) - + #### 📧 Пожелания, предложения, замечания - telegramm [@bakhirev](https://t.me/bakhirev) (приоритетный способ связи) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) diff --git a/documents/ZH.md b/documents/ZH.md index 163000a..fdcb96a 100644 --- a/documents/ZH.md +++ b/documents/ZH.md @@ -32,34 +32,36 @@ ### Table of contents - [如何 quickly 查阅 commit 的 次数？](#link-4) -- [How to create a report?](#link-5) +- [How to create a local report with using library?](#link-5) - [如何 combine 作者？](#link-6) - [如何从 git 导出数据？](#link-7) - [供网上浏览](#link-8) - [在没有互联网的情况下观看](#link-9) - [If you use PowerShell in Windows](#link-10) - [如何在线查看报告？](#link-11) - - [如何在没有网络环境下查看报告？ ](#link-12) -- [如何在没有网络环境下查看报告？](#link-13) -- [如何重打包报告文件？](#link-14) -- [如何查看微服务组的报告？](#link-15) -- [如何将界面重新配色为公司专有颜色？](#link-16) -- [如何签署提交？](#link-17) -- [How to add checking for commit message?](#link-18) - - [ Use file commit-msg](#link-19) - - [ Use package pre-commit](#link-20) -- [如何自动化数据采集？](#link-21) - - [With backend](#link-22) - - [没有后端](#link-23) -- [DevOps ](#link-24) - - [公共服务器](#link-25) - - [专用服务器](#link-26) - - [Docker 图像更新](#link-27) -- [️ About application](#link-28) - - [Architecture](#link-29) - - [释出版本大约每半年一次。接下来发生什么情况：](#link-30) - - [如何添加或编辑翻译？](#link-31) - - [愿望，建议，意见](#link-32) + - [Using website](#link-12) + - [Use the library ](#link-13) + - [Use the library ](#link-14) + - [Use source code](#link-15) +- [如何重打包报告文件？](#link-16) +- [如何查看微服务组的报告？](#link-17) +- [如何将界面重新配色为公司专有颜色？](#link-18) +- [如何签署提交？](#link-19) +- [How to add checking for commit message?](#link-20) + - [ Use file commit-msg](#link-21) + - [ Use package pre-commit](#link-22) +- [如何自动化数据采集？](#link-23) + - [With backend](#link-24) + - [没有后端](#link-25) +- [DevOps ](#link-26) + - [公共服务器](#link-27) + - [专用服务器](#link-28) + - [Docker 图像更新](#link-29) +- [️ About application](#link-30) + - [Architecture](#link-31) + - [释出版本大约每半年一次。接下来发生什么情况：](#link-32) + - [如何添加或编辑翻译？](#link-33) + - [愿望，建议，意见](#link-34) ### 🚀 如何 quickly 查阅 commit 的 次数？ 在项目的根目录中执行以下命令： @@ -67,11 +69,16 @@ git shortlog -s -n -e ``` -### 🏭 How to create a report? -If you have NodeJS, you can run: +### 🏭 How to create a local report with using library? +NodeJS: ``` npx assayo ``` +PHP: +``` +composer require bakhirev/assayo +vendor/bin/assayo +``` The script will create a folder `./assayo` with a report about repository: ``` ./assayo/index.html - report @@ -111,40 +118,47 @@ By default, the output encoding may not match UTF-8 and the resulting log file w ``` Or open a saved file and manually change the encoding to UTF-8. -### 📈 如何在线查看报告？ +### 如何在线查看报告？ + +#### 📈 Using website - 切换到 [网站](https://assayo.online/) - 按下按钮 “[示范](https://assayo.online/demo?lang=ru)” - 拖放文件 `log.txt` 在浏览器窗口中 - -#### 如何在没有网络环境下查看报告？ (NodeJS) -- Run `npx assayo` -- Open `./assayo/index.html` -### 如何在没有网络环境下查看报告？ +#### Use the library (NodeJS) +- run `npx assayo` +- open `./assayo/index.html` + +#### Use the library (PHP) +- run `composer require bakhirev/assayo` +- run `vendor/bin/assayo` +- open `./assayo/index.html` + +#### Use source code - 下载这个存储库 - 拖放文件 `log.txt` 到文件夹 `/build` - 要运行 `/build/index.html` - 或是拖放文件夹 `/build` 到我的仓库 (它所在的地方 `log.txt`). 可以改变名称。比如，从名称 `/build` 到名称 `/report` 重要的事情是，必须让log.txt这个文件是通过命令创建出来的，这样它就可以在没有网的时候查看了。 - -### 如何重打包报告文件？ + +### 🏭 如何重打包报告文件？ - 下载这个储存库 - 要执行 `npm install` - 要执行 `npm run build:local` - 最新的构建将在文件夹 `/build` - -### 🏭 如何查看微服务组的报告？ + +### 🗃️ 如何查看微服务组的报告？ - 为每个微服务生成文件 `log.txt` (`log-1.txt`, `log-2.txt`, `log-3.txt` 等等) - 参见“如何在有网络环境下查看报告”。在最后一步，将所有文件同时拖入浏览器窗口。 - 参见“如何在没有网络环境下查看报告”。第二步将所有微服务文件拖动到 (`log-1.txt`, `log-2.txt`, `log-3.txt` 等等) 到报表文件夹 (`/build`). - -### 🗃️ 如何将界面重新配色为公司专有颜色？ + +### 🎨 如何将界面重新配色为公司专有颜色？ 您可以为界面创建自己的主题。可以修改： - **标题**. 你可以在网址参数中指定它 ```title```. 例如: ```?title=You Company``` - **CSS样式**. 为了做到这一点，你需要准备一个CSS文件并在网址参数中指明其地址 ```theme```. 例如: ```?theme=//company.com/some.css```. 你可以使用类名作为选择器。大多数情况下，他们在新版本发布时不会发生变化。 - **语言**. 你可以把它放在网址的参数中。 ```lang```. 例如: ```?lang=es``` - -### 🎨 如何签署提交？ + +### 📝 如何签署提交？ 遵循实践 [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/). 例如: ``` JIRA-1234 feat(profile): Added avatar for user @@ -153,10 +167,10 @@ JIRA-1234 feat(profile): Added avatar for user - 工作类别 `(feat, fix, style, refactor, test, doc 等等)` - 工作领域 `(profile - 地盘组, 网页 或新功能, 一句话)` - 职位描述 `(Added avatar for user)` - -### 📝 How to add checking for commit message? - -#### 👮 Use file `commit-msg` + +### 👮 How to add checking for commit message? + +#### Use file `commit-msg` 1. Create file `commit-msg` in folder `.git/hooks/` 2. Add this text in file: ``` @@ -166,7 +180,7 @@ if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)(( exit 1 fi ``` - + #### Use package [pre-commit](https://www.npmjs.com/package/pre-commit) 1. Add in file `package.json` property `commit-msg`: ``` @@ -178,27 +192,27 @@ fi ... ``` 2. Run command `npm install pre-commit` - -### 如何自动化数据采集？ - -#### 📚 With backend -- use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); +### 📚 如何自动化数据采集？ + +#### With backend +- use module [Assayo Crawler](https://github.com/bakhirev/assayo-crawler); + #### 没有后端 - 克隆您的仓库; - 复制文件夹 `build` 从当前仓库; - 打开 `build/index.html` 在浏览器中添加书签; - 添加一个快捷方式 `build/assets/ci-cd.sh` 自动启动文件夹 (Windows); 每次重启计算机，该脚本将更新统计数据，这些数据自动添加到主分支中。 - -### DevOps (CI/CD) - -#### 🛠️ 公共服务器 + +### 🛠️ DevOps (CI/CD) + +#### 公共服务器 您可以将数据构建报告文件发布到公共URL，可以使用网站来显示它。 [assayo](https://assayo.online/). 指定数据所在的地址作为URL参数 ```dump```: ``` https://assayo.online/demo/?dump=//you_site.com/some/log.txt ``` - + #### 专用服务器 - 下载 [docker镜像](https://hub.docker.com/r/bakhirev/assayo); - 在本地网络中运行它; @@ -209,31 +223,31 @@ assayo_url - assayo容器的URL地址，它监听80端口; you_url - git日志的容器的URL地址; ``` 默认情况下，镜像会被启动在地址 ```http://127.0.0.1:80/```. 如果没有成功，请检查你的80端口是否可用. - + #### Docker 图像更新 - 运行命令 ```npm run build:docker``` - 运行命令 ```docker build -t assayo .``` - 检查结果 ```docker run --name assayo -p 80:80 -d assayo```; - 运行命令 ```docker tag assayo bakhirev/assayo:latest```; - 提交容器映像到 Docker Hub ```docker push bakhirev/assayo:latest```; - -### ️ About application - -#### 🛠️ Architecture + +### 🛠️ ️ About application + +#### 📐 Architecture 1. [Reports showcase UI](https://github.com/bakhirev/assayo-showcase) displays a list of available reports. Each report consists of a title, description, and a list of repositories. 2. [Crawler service](https://github.com/bakhirev/assayo-crawler) collects repository logs for the report. 3. [Log visualization UI](https://github.com/bakhirev/assayo) **(you here)** displays report. Needs a log file for work. - -#### 📐 释出版本大约每半年一次。接下来发生什么情况： + +#### 🈯 释出版本大约每半年一次。接下来发生什么情况： 看 [主要文件](https://github.com/bakhirev/assayo/blob/main/documents/RU.md) - -#### 🈯 如何添加或编辑翻译？ + +#### 🗺️ 如何添加或编辑翻译？ 您可以在“翻译”部分添加新翻译或更正当前翻译。 ```ts/translations/```. [指示手册](https://github.com/firstcontributions/first-contributions) - -#### 🗺️ 愿望，建议，意见 + +#### 📧 愿望，建议，意见 - telegramm [@bakhirev](https://t.me/bakhirev) (优先通信方法) - [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru) - 网站 [https://assayo.online/](https://assayo.online/?ref=github&lang=zh) diff --git a/documents/src/json/de.json b/documents/src/json/de.json index 32edd3b..cc3faac 100644 --- a/documents/src/json/de.json +++ b/documents/src/json/de.json @@ -53,16 +53,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -136,7 +145,7 @@ "h3": "Wie kann ich den bericht sehen?" }, { - "h4": "Online" + "h4": "Using website" }, { "li": [ @@ -146,16 +155,26 @@ ] }, { - "h4": "Offline (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h4": "Offline" + "h4": "Use the library (PHP)" + }, + { + "li": [ + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" }, { "li": [ diff --git a/documents/src/json/en.json b/documents/src/json/en.json index b80859c..3590523 100644 --- a/documents/src/json/en.json +++ b/documents/src/json/en.json @@ -56,16 +56,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -76,7 +85,7 @@ ] }, { - "p": "If you do not have NodeJS , see the items \"How to download data from git?\" and \"How to view the report?\"" + "p": "If you do not have NodeJS/PHP , see the items \"How to download data from git?\" and \"How to view the report?\"" }, { "h3": "How to concat authors?" @@ -139,7 +148,7 @@ "h3": "How to view the report?" }, { - "h4": "Online" + "h4": "Using website" }, { "li": [ @@ -149,16 +158,26 @@ ] }, { - "h4": "Offline (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h4": "Offline" + "h4": "Use the library (PHP)" + }, + { + "li": [ + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" }, { "li": [ @@ -383,9 +402,9 @@ }, { "li": [ - "telegramm [@bakhirev](https://t.me/bakhirev) (priority method of communication)", - "[alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru)", - "website [https://assayo.online/](https://assayo.online/?ref=github&lang=en)" + "\uD83D\uDCF1 [https://t.me/bakhirev](https://t.me/bakhirev) (priority method of communication)", + "\uD83D\uDCE7 [alexey-bakhirev@yandex.ru](mailto:alexey-bakhirev@yandex.ru)", + "\uD83C\uDF10 [https://assayo.online/](https://assayo.online/?ref=github&lang=en)" ] } ] diff --git a/documents/src/json/es.json b/documents/src/json/es.json index 855393a..8267313 100644 --- a/documents/src/json/es.json +++ b/documents/src/json/es.json @@ -56,16 +56,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -139,33 +148,43 @@ "h3": "¿Cómo ver el informe?" }, { - "h4": "Online" + "h4": "Using website" }, { "li": [ - "Ir a [sitio web](https://assayo.online/)", - "Pulse el botón [Demo](https://assayo.online/demo)»", - "Arrastrar y soltar archivo `log.txt` en la ventana del navegador" + "ir a [sitio web](https://assayo.online/)", + "pulse el botón [Demo](https://assayo.online/demo)»", + "arrastrar y soltar archivo `log.txt` en la ventana del navegador" ] }, { - "h4": "Offline (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h4": "Offline" + "h4": "Use the library (PHP)" }, { "li": [ - "Descargar este repositorio", - "Arrastrar y soltar archivo `log.txt` en la carpeta `/build`", - "Lanzar `/build/index.html`", - "O arrastrar una carpeta `/build` a su repositorio (donde se encuentra ' log.txt`). Puede cambiar el nombre. Por ejemplo `/build` contra `/report`" + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" + }, + { + "li": [ + "descargar este repositorio", + "arrastrar y soltar archivo `log.txt` en la carpeta `/build`", + "lanzar `/build/index.html`", + "o arrastrar una carpeta `/build` a su repositorio (donde se encuentra ' log.txt`). Puede cambiar el nombre. Por ejemplo `/build` contra `/report`" ] }, { diff --git a/documents/src/json/fr.json b/documents/src/json/fr.json index 817f51d..0edc4a1 100644 --- a/documents/src/json/fr.json +++ b/documents/src/json/fr.json @@ -56,16 +56,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -139,7 +148,7 @@ "h3": "Comment voir le rapport en ligne?" }, { - "h4": "Online" + "h4": "Using website" }, { "li": [ @@ -149,16 +158,26 @@ ] }, { - "h4": "Offline (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h4": "Offline" + "h4": "Use the library (PHP)" + }, + { + "li": [ + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" }, { "li": [ diff --git a/documents/src/json/ja.json b/documents/src/json/ja.json index 197cfc1..3f780f2 100644 --- a/documents/src/json/ja.json +++ b/documents/src/json/ja.json @@ -56,16 +56,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -139,7 +148,7 @@ "h3": "レポートを表示するにはどうすればよいですか？ " }, { - "h4": "Online" + "h4": "Using website" }, { "li": [ @@ -149,16 +158,26 @@ ] }, { - "h4": "Offline (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h4": "Offline" + "h4": "Use the library (PHP)" + }, + { + "li": [ + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" }, { "li": [ diff --git a/documents/src/json/pt.json b/documents/src/json/pt.json index 386891f..0d29117 100644 --- a/documents/src/json/pt.json +++ b/documents/src/json/pt.json @@ -56,16 +56,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -139,7 +148,7 @@ "h3": "Como ver o relatório?" }, { - "h4": "Online" + "h4": "Using website" }, { "li": [ @@ -149,16 +158,26 @@ ] }, { - "h4": "Offline (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h4": "Offline" + "h4": "Use the library (PHP)" + }, + { + "li": [ + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" }, { "li": [ diff --git a/documents/src/json/ru.json b/documents/src/json/ru.json index 168c145..fcad32c 100644 --- a/documents/src/json/ru.json +++ b/documents/src/json/ru.json @@ -136,7 +136,7 @@ "h3": "Как посмотреть отчёт?" }, { - "h4": "Онлайн" + "h4": "Через сайт" }, { "li": [ @@ -146,23 +146,33 @@ ] }, { - "h4": "Офлайн (с NodeJS)" + "h4": "Используя библиотеку (NodeJS)" }, { "li": [ - "Выполнить `npx assayo`", - "Открыть `./assayo/index.html`" + "выполнить `npx assayo`", + "открыть `./assayo/index.html`" ] }, { - "h4": "Офлайн" + "h4": "Используя библиотеку (PHP)" }, { "li": [ - "Скачать этот репозиторий", - "Перетащить файл `log.txt` в папку `/build`", - "Запустить `/build/index.html`", - "Или перетащить папку `/build` к себе в репозиторий (туда, где лежит `log.txt`). Можно сменить название. Например с `/build` на `/report`" + "выполнить `composer require bakhirev/assayo`", + "выполнить `vendor/bin/assayo`", + "открыть `./assayo/index.html`" + ] + }, + { + "h4": "Без установки библиотек" + }, + { + "li": [ + "скачать этот репозиторий", + "перетащить файл `log.txt` в папку `/build`", + "запустить `/build/index.html`", + "или перетащить папку `/build` к себе в репозиторий (туда, где лежит `log.txt`). Можно сменить название. Например с `/build` на `/report`" ] }, { diff --git a/documents/src/json/zh.json b/documents/src/json/zh.json index c340b63..cf1bf87 100644 --- a/documents/src/json/zh.json +++ b/documents/src/json/zh.json @@ -56,16 +56,25 @@ ] }, { - "h3": "How to create a report?" + "h3": "How to create a local report with using library?" }, { - "p": "If you have NodeJS, you can run:" + "p": "NodeJS:" }, { "pre": [ "npx assayo" ] }, + { + "p": "PHP:" + }, + { + "pre": [ + "composer require bakhirev/assayo", + "vendor/bin/assayo" + ] + }, { "p": "The script will create a folder `./assayo` with a report about repository:" }, @@ -138,6 +147,9 @@ { "h3": "如何在线查看报告？" }, + { + "h4": "Using website" + }, { "li": [ "切换到 [网站](https://assayo.online/)", @@ -146,16 +158,26 @@ ] }, { - "h4": "如何在没有网络环境下查看报告？ (NodeJS)" + "h4": "Use the library (NodeJS)" }, { "li": [ - "Run `npx assayo`", - "Open `./assayo/index.html`" + "run `npx assayo`", + "open `./assayo/index.html`" ] }, { - "h3": "如何在没有网络环境下查看报告？" + "h4": "Use the library (PHP)" + }, + { + "li": [ + "run `composer require bakhirev/assayo`", + "run `vendor/bin/assayo`", + "open `./assayo/index.html`" + ] + }, + { + "h4": "Use source code" }, { "li": [ diff --git a/documents/src/lib/JsonToMd/TableOfContent.js b/documents/src/lib/JsonToMd/TableOfContent.js index a1c8bbc..890af95 100644 --- a/documents/src/lib/JsonToMd/TableOfContent.js +++ b/documents/src/lib/JsonToMd/TableOfContent.js @@ -9,6 +9,7 @@ const SMILES = [ '📤', // 7 null, // 8 null, // 8 + null, // 8 null, // 9 '📈', // 10 null, // 9