beautify UI

Author: vadim-levotski

.github/workflows/markdown_linter_rules.rb

@@ -2,8 +2,13 @@
 exclude_rule 'MD004'
 exclude_rule 'MD007'
 exclude_rule 'MD013'
+exclude_rule 'MD023' # disable -> Headers must start at the beginning of the line
 exclude_rule 'MD024'
 exclude_rule 'MD029'
-exclude_rule 'MD033'
+exclude_rule 'MD031'  # Allow blank lines inside fenced blocks
+exclude_rule 'MD032'  # disable -> Lists should be surrounded by blank lines
+exclude_rule 'MD033'  # Allow inline HTML/custom syntax
 exclude_rule 'MD036'
+#exclude_rule 'MD041'  # No H1 header required at the top
+rule 'MD046', :style => 'indented'
 # rule 'MD029', :style => 'ordered'

docs/css/extra.css

@@ -69,3 +69,8 @@ body[data-md-color-scheme=slate] table {
    box-shadow: 0px 0px 6px rgba(0, 0, 0, 0.5);
    border: 2px solid #ddd;
 }
+
+.md-typeset .admonition,
+.md-typeset details {
+  font-size: 0.8rem; /* adjust as needed */
+}

docs/faq.md

@@ -241,9 +241,9 @@ TL;DR Нет.
 
 Заходите на сайте biznes.gov.pl и меняете
 
-- адрес проживания - [Adres zamieszkania](registration.md#5-adres-prozhivaniia)
-- адрес для корреспонденции - [Adres do doręczeń](registration.md#8-pochtovyi-adres)
-- адрес налогового офиса - [Urząd skarbowy](registration.md#11-skarbovy-uzhond)
+- адрес проживания - [Adres zamieszkania](registration_jdg#5-adres-prozhivaniia)
+- адрес для корреспонденции - [Adres do doręczeń](registration_jdg#8-pochtovyi-adres)
+- адрес налогового офиса - [Urząd skarbowy](registration_jdg#11-skarbovy-uzhond)
 
 ### Можно ли оформить ИП без постоянного места регистрации
 

docs/index.md

@@ -1,13 +1,17 @@
 # Приветствуем в гайде-путеводителе по JDG
 
-Jednoosobowa działalność gospodarcza — это форма бизнеса в Польше, аналогичная
-ИП или ФОП в странах бывшего СНГ.
+!!! info "Jednoosobowa działalność gospodarcza"
+    это форма бизнеса в Польше, аналогичная ИП или ФОП в странах бывшего СНГ.
 
-Присоединяйтесь к [:telegram: чату про JDG][0] в Польше.
+У вас есть вопросы, хотите узнать больше или помочь с редактированием гайда? 
 
-Бухгалтерия для JDG: [Legal Tax Level][4]
+!!! tip "Присоединяйтесь к нам в Telegram:"
+    - [:telegram: чат про JDG в Польше][0]
+    - [:telegram: чат контрибьюторов][5]
 
-Хотите помочь с редактированием информации на сайте? Присоединяйтесь к [:telegram: чату контрибьюторов][5].
+
+!!! success "Бухгалтерия для JDG"
+    [Legal Tax Level][4]
 
 ## Кто может открыть JDG в Польше
 

docs/infakt_routine.md

@@ -32,7 +32,8 @@
 
 Нажимаете кнопку **Zapisz szkic** для сохранения данных. Фактура записана!
 
-> Важно: На этом этапе фактура еще не участвует в расчете налоговой базы за выбранный месяц (пока она находится в статусе `SZKIC`). Для того чтобы фактура попала в зачет, необходимо ее напечатать или выслать клиенту.
+!!! warning "Важно"
+    На этом этапе фактура еще не участвует в расчете налоговой базы за выбранный месяц (пока она находится в статусе `SZKIC`). Для того чтобы фактура попала в зачет, необходимо ее напечатать или выслать клиенту.
 
 Для этого нужно в [списке фактур][1] выбрать нужную фактуру, и выбрать **Pobierz PDF**, там же будет и выбор языков.
 
@@ -44,7 +45,8 @@
 
 ## Оплата налогов
 
-> Убедитесь что все фактуры добавлены и в статусе `WYDRUKOWANO` или `WYSŁANO`, а так же все курсовые разницы за отчетный период внесены и учтены.
+!!! warning "Важно"
+    Убедитесь что все фактуры добавлены и в статусе `WYDRUKOWANO` или `WYSŁANO`, а так же все курсовые разницы за отчетный период внесены и учтены.
 
 Узнать свой счет для уплаты налогов можно [тут][36].
 Infakt получает номер счета автоматически при настройке.
@@ -66,16 +68,19 @@ Infakt получает номер счета автоматически при
 
 Оплата вручную происходит в банковском приложении.
 
-На примере PKO: Выполните Przelew Podatkowy
+!!! example "На примере PKO"
+    Выполните Przelew Podatkowy
 
-1. выберите секцию `Pozostałe`
-2. вводите в поиске `PPE`
-3. введите номер своего налогового счета
-4. введите за какой период оплачивается налог
-5. выберите в списке Typ identyfikatora `NIP`
-6. введите свой номер NIP
+    1. выберите секцию `Pozostałe`
+    2. вводите в поиске `PPE`
+    3. введите номер своего налогового счета
+    4. введите за какой период оплачивается налог
+    5. выберите в списке Typ identyfikatora `NIP`
+    6. введите свой номер NIP
 
-Выберите счет с которого хотите заплатить налог. Имеет смысл платить с фирмового, так как в банках движение по счету
+    Выберите счет с которого хотите заплатить налог.
+
+Имеет смысл платить с фирмового, так как в банках движение по счету
 может быть условием бесплатности пакета, введите сумму платежа со страницы infakt и совершите платеж.
 
 По окончанию отметьте в infakt налог как оплаченный.
@@ -140,8 +145,9 @@ Infakt получает номер счета автоматически при
 
 ## Получение оплаты и учет курсовых разниц
 
-При получении оплаты в иностранной валюте могут возникать курсовые разницы. Закон предписывает учитывать курсовые
-разницы - как положительные, так и отрицательные. Курсовая разница не трактуется как доход или расход, а является корректировкой дохода, поэтому учитывается при его подсчете.
+!!! info
+    При получении оплаты в иностранной валюте могут возникать курсовые разницы. Закон предписывает учитывать курсовые
+    разницы - как положительные, так и отрицательные. Курсовая разница не трактуется как доход или расход, а является корректировкой дохода, поэтому учитывается при его подсчете.
 
 Для учета курсовых разниц нужно знать курс (`К1`), по которому выставлена фактура, и курс нацбанка Польши (`К2`) на
 последний рабочий день, предшествующий дате поступления оплаты. Если дата выставления фактуры отличается от даты продажи -
@@ -163,8 +169,11 @@ Infakt получает номер счета автоматически при
 
 * В поле со звёздочкой следует ввести фактический курс обмена или оставить поле пустым, чтобы применить средний курс NBP с предыдущего рабочего дня предшествующего дню совершения операции.
 
-❗️Если у вас выбран план подписки Premium в Infakt, курсовые разницы будут учтены автоматически при отметке фактуры
-как оплаченной. Если вы используете более дешевые планы подписки, вы можете воспользоваться следующей инструкцией.
+!!! tip "Infakt Premium"
+    Если у вас выбран план подписки Premium в Infakt, курсовые разницы будут учтены автоматически при отметке фактуры
+    как оплаченной.
+
+Если вы используете более дешевые планы подписки, вы можете воспользоваться следующей инструкцией.
 
 Для внесения курсовой разницы (`K2` != `K1`, или `K3` != `K2`), необходимо добавить `Dowód wewnętrzny`. Для этого
 перейдите в [Przychody -> Faktury][1], и там:

docs/pesel.md

@@ -5,21 +5,19 @@ Profil Zaufany.
 
 ## Что такое PESEL
 
-PESEL — это личный номер из 11 цифр, который присваивается каждому человеку, легально проживающему в Польше. Дети его
-получают при рождении.
-
-Этот номер нужен практически везде: при общении с государственными структурами, открытии счета в банке, получении
-медицинских услуг и т.д.
+!!! question "Номер PESEL"
+    это личный номер, который присваивается каждому человеку, легально проживающему в Польше.
+    Дети его получают при рождении.
+    Этот номер нужен практически везде: при общении с государственными структурами, открытии счета в банке, получении медицинских услуг и т.д.
 
 ## Что означают цифры в номере
 
 Номер PESEL состоит из 11 цифр:
 
-```markdown
-|910503|014|5|9|
-```
+!!! example "PESEL example"
+    |910503|014|5|9|
 
-- 1-6 цифры — дата рождения, с указанием столетия. Например человек, рожденный 3 мая 1991, имеет начальные номера PESEL 910503
+- 1-6 цифры — дата рождения, с указанием столетия (в формате ГГММДД). Например, человек рожденный 3 мая 1991, имеет начальные номера PESEL 910503
 - 7-9 цифры — номер серии
 - 10-я цифра  обозначает пол: 0, 2, 4, 6, 8 – женщины, 1, 3, 5, 7, 9 – мужчины
 - 11-я цифра — контрольная цифра, для проверки правильности всего номера
@@ -61,38 +59,37 @@ PESEL — это личный номер из 11 цифр, который при
 Приходим в ужонд, с паспортом, и заполненным заявлением, либо заполняем на месте.
 В заявлении пишем следующее правовое основание:
 
-> ZAŁĄCZNIK NR 1. PKT. 1 ROZPORZĄDZENIA MINISTRA CYFRYZACJI Z DNIA 29
-> CZERWCA 2020 ROKU W SPRAWIE PROFILU ZAUFANEGO I PODPISU ZAUFANEGO
-> DZ.U.2020 POZ.1194
+!!! Quote "правовое основание:"
+    ZAŁĄCZNIK NR 1. PKT. 1 ROZPORZĄDZENIA MINISTRA CYFRYZACJI Z DNIA 29
+    CZERWCA 2020 ROKU W SPRAWIE PROFILU ZAUFANEGO I PODPISU ZAUFANEGO
+    DZ.U.2020 POZ.1194
 
 Если вдруг начнут отказываться, есть ещё одно основание:
 
-> DZ.U. 1997 NR 121 POZ. 769; USTAWA Z DNIA 20 SIERPNIA 1997 R. O KRAJOWYM
-> REJESTRZE SĄDOWYM; ART. 35 PKT 1
-
-[Ссылка на постановление][7]
-
-Основание для детей до 3-х лет:
-
-> Ustawa z dnia 4 lutego 2011 r. o opiece nad dziećmi w wieku do lat 3
-> POZ. 235 ROZDZIAŁ 1, ART. 3A
+!!! Quote "правовое основание:"
+    DZ.U. 1997 NR 121 POZ. 769; USTAWA Z DNIA 20 SIERPNIA 1997 R. O KRAJOWYM
+    REJESTRZE SĄDOWYM; ART. 35 PKT 1
 
-Основание для детей от 3-х до 18-ти лет:
+    [Ссылка на постановление][7]
 
-> USTAWA O SYSTEMIE OŚWIATY Z DNIA 7 WRZEŚNIA 1991 R.
-> (TJ. Z DNIA 31 PAZDZIERNIKA 2016 R. DZ. U. Z 2016 R. POZ.1943)
-> ART. 92K. UST. 2 PKT 2F
+!!! Quote "Основание для детей до 3-х лет:"
+    Ustawa z dnia 4 lutego 2011 r. o opiece nad dziećmi w wieku do lat 3
+    POZ. 235 ROZDZIAŁ 1, ART. 3A
 
-[Ссылка на постановление][8]
+!!! Quote "Основание для детей от 3-х до 18-ти лет:"
+    USTAWA O SYSTEMIE OŚWIATY Z DNIA 7 WRZEŚNIA 1991 R.
+    (TJ. Z DNIA 31 PAZDZIERNIKA 2016 R. DZ. U. Z 2016 R. POZ.1943)
+    ART. 92K. UST. 2 PKT 2F
 
-Взрослые от 18-ти лет:
+    [Ссылка на постановление][8]
 
-> PARAGRAF 5 UST. 3, PARAGRAF 8 UST. 1 — ROZPORZĄDZENIE MINISTRA CYFRYZACJI
-> Z DNIA 5 PAŹDZIERNIKA 2016 R. W SPRAWIE PROFILU ZAUFANEGO ELEKTRONICZNEJ
-> PLATFORMY USŁUG ADMINISTRACJI PUBLICZNEJ, OPUBLIKOWANE W DZIENNIKU USTAW
-> R.P. Z 2016, POZ. 1633.
+!!! Quote "Взрослые от 18-ти лет:"
+    PARAGRAF 5 UST. 3, PARAGRAF 8 UST. 1 — ROZPORZĄDZENIE MINISTRA CYFRYZACJI
+    Z DNIA 5 PAŹDZIERNIKA 2016 R. W SPRAWIE PROFILU ZAUFANEGO ELEKTRONICZNEJ
+    PLATFORMY USŁUG ADMINISTRACJI PUBLICZNEJ, OPUBLIKOWANE W DZIENNIKU USTAW
+    R.P. Z 2016, POZ. 1633.
 
-[Ссылка на постановление][9]
+    [Ссылка на постановление][9]
 
 Если в каком-то ужонде отказались выдавать PESEL без мельдунка, либо
 сказали ждать 30 дней — пробуйте получить песель в другом ужонде.

docs/pismo_ogolne.md

@@ -1,6 +1,7 @@
 # Как отправить письмо в налоговую (Pismo ogólne do Urzędu Skarbowego)
 
-"Pismo ogólne do Urzędu Skarbowego" — это общий тип письма, которое отправляется в налоговую службу Польши (Urzęd Skarbowy) в случае, когда нет специально предусмотренной формы для подачи запроса, заявления или объяснения.
+!!! info "Pismo ogólne do Urzędu Skarbowego"
+    это общий тип письма, которое отправляется в налоговую службу Польши (Urzęd Skarbowy) в случае, когда нет специально предусмотренной формы для подачи запроса, заявления или объяснения.
 
 Его можно использовать для:
 

docs/pz.md

@@ -1,27 +1,43 @@
 # Profil Zaufany (доверенный профиль)
 
-Profil Zaufany — бесплатный метод проверки личности для работы с государственными учреждениями.
-Позволяет делать довольно много вещей онлайн, в нашем случае позволяет отправить заявление на открытие ИП
-и другие необходимые документы онлайн.
+!!! question "Что такое Profil Zaufany"
+    Это бесплатный метод проверки личности для работы с государственными учреждениями.
+    Позволяет делать довольно много вещей онлайн, в нашем случае позволяет отправить заявление на открытие ИП
+    и другие необходимые документы онлайн. Подробнее можно узнать на [сайте gov.pl][1]
 
 Для регистрации доверенного профиля нужен номер PESEL.
 
 ## Profil Zaufany через банк
 
 Если вы открывали счет в банке уже с номером PESEL, то вы можете использовать банковский аккаунт для создания профиля.
 
-1. Необходимо зайти по адресу: [ePUAP][1].
-2. Пройти: Zaloguj się -> profil zaufany -> Zaloguj się przy pomocy banku lub innego dostawcy и выбрать ваш банк.
+1. Необходимо зайти по адресу: [ePUAP][2].
+2. Пройти: `Zaloguj się` -> `profil zaufany` -> `Zaloguj się przy pomocy banku lub innego dostawcy` и выбрать ваш банк.
 
 Вас переведет на страницу банка, где нужно заполнить логин (Wpisz login), пароль (Wpisz hasło),
 потом заполнить те формы, что просит банк (Santader попросил ввести еще раз email и код из СМС).
 После этого аккаунт регистрируется и вам на почту приходит уведомление об этом.
 
-Теперь можно зайти на сайт [Profil Zaufany][2] и войти через иконку банка в свой доверенный профиль.
+Теперь можно зайти на сайт [Profil Zaufany][3] и войти через иконку банка в свой доверенный профиль.
 Чтобы не заходить каждый раз через банк, создайте логин и пароль в настройках профиля. Если не получается — восстановите
 пароль через почту и задайте новый. После этого можно будет логиниться с помощью логина-пароля.
 
+## Profil Zaufany online через gov.pl
+
+Если у вас ещё нет счёта в банке, то можно заполнить заявление (wniosek) в ужонде или онлайн.
+
+Чтобы заполнить заявление онлайн, необходимо перейти по ссылке на [сайт gov.pl][1].
+
+- нажимаем `Załóż profil zaufany`
+- далее выбираете `В офисе`, т.е. заполнить онлайн и подтвердить в офисе
+- проходим капчу
+- заполняем форму
+- подтверждаете номер телефона и емейл (адрес почты и номер телефона должны быть действующими и к ним у вас должен быть постоянный доступ)
+- выбираете удобное место подтверждения из списка - ужонд
+- берёте паспорт, PESEL и идёте подтверждать
+
 <!-- resources -->
 
-[1]: https://epuap.gov.pl/wps/portal
-[2]: https://pz.gov.pl
+[1]: https://www.gov.pl/web/profilzaufany
+[2]: https://epuap.gov.pl/wps/portal
+[3]: https://pz.gov.pl