Skip to content

Commit

Permalink
new post
Browse files Browse the repository at this point in the history
  • Loading branch information
yktoo committed Sep 15, 2024
1 parent 4440b29 commit c5f7b65
Show file tree
Hide file tree
Showing 2 changed files with 190 additions and 0 deletions.
95 changes: 95 additions & 0 deletions content/blog/posts/0895/index.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
type: post
date: "2024-09-15T16:16:07+02:00"
title: "3.10.0 Donaghadee"
tags:
- Comentario
- web
- software
- development
- release
- Go
- Angular
- Commento++
image: "https://res.cloudinary.com/yktoo/image/upload/v1726409725/blog/ni6elgzbaxv5cemqgbga.jpg"
imageCredit: "AI-generated image."
series: comentario
software: comentario
---

New version [Comentario **3.10.0 Donaghadee**](https://gitlab.com/comentario/comentario/-/releases/v3.10.0) has seen the light of day.

[Comentario](/software/comentario) is a fast and powerful free comment server for web pages, written in Go.

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726409725/blog/ni6elgzbaxv5cemqgbga.jpg" "AI-generated image." >}}

> **An important announcement:** if you're only interested in news about Comentario, feel free to bookmark the [Comentario series page](/series/comentario). It also provides a dedicated [<i class="fas fa-rss"></i> RSS feed](https://yktoo.com/en/blog/series/comentario/index.xml).
## What's new

<!--more-->

### Spinners

The embedded Comentario comments now display a spinner during (potentially) long-running operations, such as signing in, submitting a comment, voting on a comment, stickying a comment etc. ([#94](https://gitlab.com/comentario/comentario/-/issues/94)):

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726413253/blog/ed80vo45b8wq2gwgz5i3.gif" "Spinners showing during API calls." "border shadow" >}}

It also addresses another problem related to submitting comments: the `Add Comment` button gets disabled after the first click, making it impossible to repeatedly submit the same comment ([#116](https://gitlab.com/comentario/comentario/-/issues/116)).

### Language fallback path

Language fallback path handling has been added ([#121](https://gitlab.com/comentario/comentario/-/issues/121), thanks to [@Func86](https://gitlab.com/Func86)). Now, if there's no direct match for the requested page language, the embedded Comentario will try to find an appropriate available regional or script variant first, before falling back to a generic variant and, finally, to the global default (English).

For those interested, the fallback path should look a bit like below:

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726414283/blog/y75umj77wx8oew8vefac.svg" "Language variants diagram." >}}

### Comment properties

Comment properties page now also show comment text in HTML, as well as its Markdown source:

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726415184/blog/xvnqfrjmkq158dd2ogbj.gif" "Comment text in Properties." "border shadow" >}}

### Domain user properties

Domain owners got the ability to change their users' notification settings on the corresponding Edit page ([#119](https://gitlab.com/comentario/comentario/-/issues/119)):

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726415390/blog/qwsyfnflb4ccde4f7qrv.png" "Edit domain user page with the new switches." "border shadow" >}}

### IPv6 support

Finally, Comentario fully supports registering complete IPv6 addresses, fixing bugs ([#95](https://gitlab.com/comentario/comentario/-/issues/95)) in the user and comment database tables. As a bonus, the user's or commenter's IP address and country are now displayed, too (don't worry, the below is just an example; Comentario only registers the first two bytes of the address by default):

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726415703/blog/njepket0e6piqlyfaw5e.png" "User's IP address and country." "border shadow" >}}

### Documentation

This release significantly improves on [Comentario documentation](https://docs.comentario.app/):

* Added the [Architecture](https://docs.comentario.app/en/about/architecture/) section ([#117](https://gitlab.com/comentario/comentario/-/issues/117)).
* Added Read on link to section children snippets
* Fixed and improved [Search](https://docs.comentario.app/en/search/) functionality:
* Results are ranked based on location and number of occurrences.
* Search is re-run on back/forward navigation in the browser.
* Added result count display.

### Other changes

* Embed: use `Intl.RelativeTimeFormat` for relative time ([#122](https://gitlab.com/comentario/comentario/-/issues/122))
* Embed: display localized date and time
* Embed: fix code blocks expanding beyond the card's width ([#110](https://gitlab.com/comentario/comentario/-/issues/110))
* Embed: add Jest and unit tests for `Utils`
* Embed: only *build* by default; *test* and *lint* are executed separately
* Admin UI: improve front page placeholder display, replace deprecated test code
* I18n: add translations for Chinese
* I18n: enlarge user `lang_id` col to 255 chars ([#107](https://gitlab.com/comentario/comentario/-/issues/107))
* Docs: expand self-host desc somewhat
* Docs: switch to using Hugo environments
* Docs: README: update blog link
* Support for custom user attributes
* Docker: fix `ENV` warning
* CI: run the pipeline for each commit, but publish stuff in dev/tag only
* Code: require Go 1.23.0

{{< include-file "/blog/_snippets/_comentario-footer.en.md" >}}
95 changes: 95 additions & 0 deletions content/blog/posts/0895/index.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
type: post
date: "2024-09-15T16:16:07+02:00"
title: "3.10.0 Donaghadee"
tags:
- Comentario
- веб
- софт
- разработка
- релиз
- Go
- Angular
- Commento++
image: "https://res.cloudinary.com/yktoo/image/upload/v1726409725/blog/ni6elgzbaxv5cemqgbga.jpg"
imageCredit: "Изображение: кибермозг."
series: comentario
software: comentario
---

Вышла версия [Comentario **3.10.0 Donaghadee**](https://gitlab.com/comentario/comentario/-/releases/v3.10.0).

[Comentario](/software/comentario) — это быстрый и мощный свободный сервер комментариев для веб-страниц, написанный на {{< fl "Go" >}}.

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726409725/blog/ni6elgzbaxv5cemqgbga.jpg" "Киберизображение." >}}

> **Важное объявление:** если вас в моём блоге интересуют только новости {{< fl "Comentario" >}}, добавьте в закладки [соответствующую страницу подборки](/series/comentario). Также доступна [<i class="fas fa-rss"></i> RSS-лента](https://yktoo.com/ru/blog/series/comentario/index.xml) с соответствующими постами.
## Что нового

<!--more-->

### Спиннеры

Отныне {{< fl "Comentario" >}} будет отображать спиннеры (вращающуюся анимацию) во время (потенциально) продолжительных операций, таких как логин, отправка комментария, голосование за коммент и т.п. ([#94](https://gitlab.com/comentario/comentario/-/issues/94)):

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726413253/blog/ed80vo45b8wq2gwgz5i3.gif" "Спиннеры, показываемые во время сетевых операций." "border shadow" >}}

Также исправлена ещё одна проблема, связанная с отправкой коммента: кнопка `Добавить комментарий` становится недоступной после первого клика, делая невозможной повторную отправку того же комментария ([#116](https://gitlab.com/comentario/comentario/-/issues/116)).

### Обработка вариантов языка

Добавлена обработка цепочки вариантов языка ([#121](https://gitlab.com/comentario/comentario/-/issues/121), за что благодарность [@Func86](https://gitlab.com/Func86)). Если не найдено языка, чей код полностью соответствует запрошенному страницей, встраиваемый {{< fl "Comentario" >}} сначала попробует найти подходящую альтернативу среди родственных региональных вариантов, потом — если такого не нашлось — дженерик-вариант для данного языка и, в конце концов, язык по умолчанию (английский).

Для ценителей привожу диаграмму поиска альтернатив языковых вариантов, которая примерно соответствует алгоритму, используемому в {{< fl "Comentario" >}}:

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726414283/blog/y75umj77wx8oew8vefac.svg" "Диаграмма языковых вариантов." >}}

### Свойства комментария

Страница свойств комментария теперь отображает текст коммента в {{< fl "HTML" >}} и его «исходник» в {{< fl "Markdown" >}}:

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726415184/blog/xvnqfrjmkq158dd2ogbj.gif" "Текст в свойствах комментария." "border shadow" >}}

### Свойства пользователя домена

Владельцы домена получили возможность менять настройки подписки своих пользователей на уведомления на странице редактирования пользователя ([#119](https://gitlab.com/comentario/comentario/-/issues/119)):

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726415390/blog/qwsyfnflb4ccde4f7qrv.png" "Страница редактирования пользователя домена с новыми настройками." "border shadow" >}}

### Поддержка IPv6

{{< fl "Comentario" >}} наконец-то полностью поддерживает регистрацию {{< fl "IPv6" >}}-адресов — был исправлен баг ([#95](https://gitlab.com/comentario/comentario/-/issues/95)) в таблицах БД, хранящих пользователей и комменты. В качестве бонуса, в свойствах пользователя и комментария теперь также отображаются соответствующие {{< fl "IP" >}}-адрес и страна — см. пример ниже. Кстати, по умолчанию {{< fl "Comentario" >}} записывает только первые два байта адреса.

{{< imgfig "https://res.cloudinary.com/yktoo/image/upload/v1726415703/blog/njepket0e6piqlyfaw5e.png" "IP-адрес и страна пользователя." "border shadow" >}}

### Документация

В данном релизе существенно улучшена [документация по Comentario](https://docs.comentario.app/):

* Добавлен раздел [Architecture](https://docs.comentario.app/en/about/architecture/) ([#117](https://gitlab.com/comentario/comentario/-/issues/117)).
* Добавлена ссылка {{< fl "Read on" >}} после фрагмента текста дочерней страницы.
* Исправлена и улучшена функция [поиска](https://docs.comentario.app/en/search/):
* Результаты теперь ранжируются в зависимости от места, где найдено совпадение, и количества совпадений.
* Поиск перезапускается при навигации назад-вперёд в браузере.
* Добавлен счётчик количества найденных страниц.

### Прочие изменения

* Встраиваемая часть: применение `Intl.RelativeTimeFormat` для отображения относительного времени ([#122](https://gitlab.com/comentario/comentario/-/issues/122))
* Встраиваемая часть: при наведении мыши на строку времени отображаются локальные дата и время
* Встраиваемая часть: исправлено отображение блоков кода, чтобы они не были шире карточки с комментом ([#110](https://gitlab.com/comentario/comentario/-/issues/110))
* Встраиваемая часть: добавлено использование юнит-тестов на {{< fl "Jest" >}}
* Встраиваемая часть: по умолчанию выполняется только `build`; `test` и `lint` нужно запускать явно
* Админка: улучшено отображение плейсхолдеров в процессе загрузки главной страницы
* Локализация: добавлены переводы на китайский язык
* Локализация: увеличена длина столбца `lang_id` в таблице пользователей до **255** символов ([#107](https://gitlab.com/comentario/comentario/-/issues/107))
* Документация: расширено описание для самостоятельного хостинга
* Документация: осуществлён переход на использование {{< fl "Hugo environments" >}}
* Документация: добавлена ссылка на блог {{< fl "Comentario" >}} в `README`
* Добавлена поддержка атрибутов пользователя
* {{< fl "Docker" >}}: исправлено предупреждение о `ENV`
* {{< fl "CI" >}}: сборочный пайплайн теперь запускается в любой ветке репозитория; публикация возможна по-прежнему лишь из `dev` или тега
* Для сборки теперь требуется {{< fl "Go" >}} версии 1.23.0+

{{< include-file "/blog/_snippets/_comentario-footer.ru.md" >}}

0 comments on commit c5f7b65

Please sign in to comment.