Repository :
https://github.com/FarGroup/FarManager
On branch : master
Link :
https://github.com/FarGroup/FarManager/commit/241b5c0457d6146a17c1ce87c392487d758cac0f
>---------------------------------------------------------------
commit 241b5c0457d6146a17c1ce87c392487d758cac0f
Author: Andrzej Rudnik <
aru...@arudnik.pl>
Date: Fri Sep 22 08:05:07 2023 +0200
Update Polish translation
And synchronize all translations
>---------------------------------------------------------------
241b5c0457d6146a17c1ce87c392487d758cac0f
CONTRIBUTING-PL.md | 108 +++++++++++++++++++++++++++++++++++++++++++++++++++++
CONTRIBUTING-RU.md | 22 +++++++----
CONTRIBUTING.md | 21 ++++++-----
README-PL.md | 58 ++++++++++++++++++++++++++++
README-RU.md | 47 +++++++++++++++++------
README.md | 11 ++++--
6 files changed, 235 insertions(+), 32 deletions(-)
diff --git a/CONTRIBUTING-PL.md b/CONTRIBUTING-PL.md
new file mode 100644
index 000000000..a8b71c280
--- /dev/null
+++ b/CONTRIBUTING-PL.md
@@ -0,0 +1,108 @@
+|[Angielski](CONTRIBUTING.md)|[Rosyjski](CONTRIBUTING-RU.md)|
+|-|-|
+
+### WSPÓŁPRACA
+
+> Poniższe sekcje pomogą Ci zapoznać się z naszym procesem rozwoju.
+
+#### Przesyłanie poprawek
+
+Kiedy poczujesz że Twój kod jest przydatny i zechcesz go wnieść do projektu,
+prosimy kierować się poniższymi wytycznymi:
+
+1. Jedna logiczna zmiana na poprawkę, im mniejsza łatka, tym łatwiej nam
+ ją sprawdzić i zatwierdzić.
+2. Staraj się zachować spójność z ogólnym stylem kodu.
+3. Podaj szczegółowy dziennik zmian dla swojej łatki.
+4. Jeżeli Twoja poprawka wymaga aktualizacji dokumentacji (pomoc, Encyklopedia, itp.),
+ prosimy o dołączenie potrzebnych informacji.
+ Proszę utworzyć łatkę na najnowszym kodzie programu z repozytorium.
+5. Poprawki należy przesyłać jako żądania aktualizacji repozytorium
+ lub jako pliki diff do [system zgłaszania błędów](
https://bugs.farmanager.com)
+ lub [forum](
https://forum.farmanager.com/viewforum.php?f=54).
+6. Jeżeli planujesz tworzyć duże poprawki lub chcesz być na bieżąco rozwijać Far
+ Manager, zapisz się do [listy mailingowej dla programistów](
https://groups.google.com/group/fardeven)
+ (<
fard...@googlegroups.com>).
+7. Osoby często poprawiające kod będą uprawione do pełnego dostępu do repozytorium.
+
+
+#### Kompilacja
+
+```
+cd far
+```
+
+1. Aby skompilować za pomocą Visual Studio można użyj projektu IDE lub pliku makefile.<br/>
+ Przykład dla kompilacji z msbuild i vcxproj:<br/>
+ `msbuild /property:Configuration=Release;platform=x64 far.vcxproj`<br/>
+ Przykład dla nmake i makefile:<br/>
+ `nmake /f makefile_vc`
+
+2. Aby skompilować za pomocą GCC można użyć pliku makefile.<br/>
+ Przykład dla MinGW i makefile:<br/>
+ `mingw32-make -f makefile_gcc`
+
+> Sprawdź także komentarze w plikach makefile_* dla dodatkowych parametrów kompilacji.
+
+
+#### Dziennik zmian - plik `changelog`
+
+1. Wszystkie komentarze do zatwierdzonych zmian powinny być zapisywane pliku
+ `changelog` (po angielsku).
+ Komentarze w kodzie powinny pozostać tylko jeżeli uważasz, że kod nie jest
+ oczywisty i nie będzie zrozumiały dla "przyszłych pokoleń".
+2. Najnowsze zmiany znajdują się na górze.
+3. Każdy wpis rozpoczyna się nagłówkiem w formacie:
+```
+--------------------------------------------------------------------------------
+warp 2006-12-05 01:39:38+03:00 - build 2149
+```
+4. Zmiany nie zawsze wymagają podniesienia numeru kompilacji (np. zmiany
+ kosmetyczne lub niezwiązane z kodem).
+5. Przykładowe makro do generowania nagłówka:
+ [ChangelogHeader.lua](./misc/changelog/ChangelogHeader.lua)
+
+#### farversion.m4
+
+1. Ten plik zawiera informacje używane do generowania wersji Far:
+ * `SPECIAL_VERSION`, ciąg znaków, który (jeżeli jest ustawiony), oznacza
+ kompilację jako specjalną.
+ - Przeznaczony dla wersji Far, których kod nie został jeszcze zatwierdzony
+ w repozytorium, abyśmy my i użytkownicy nie byli zdezorientowani.
+ - Jeżeli nie zostanie ustawiona, typ kompilacji zostanie zdefiniowany
+ przez zmienną środowiskową FARMANAGER_BUILD_TYPE. Jeżeli nie jest ona
+ ustawiona, typem kompilacji będzie Private.
+ Obsługiwane typy kompilacji można znaleźć w wyliczeniu VERSION_STAGE w pliku
+ plugin.hpp.
+ * `VERSION_MAJOR` - główna wersja Far (np. 3).
+ * `VERSION_MINOR` - podrzędna wersja Far (np. 0).
+ * `VERSION_REVISION` - rewizja wersji Far (np. 0).
+ * `VERSION_BUILD` - ustawiana w pliku `vbuild.m4`.
+
+
+#### vbuild.m4
+
+1. Jeżeli numer kompilacji w pliku `vbuild.m4` został zmieniony, to po zatwierdzeniu
+ zmian w repozytorium należy uruchomić `tag_build.bat`.
+
+
+#### Dodawanie nowych linii do plików językowych
+
+1. Pliki `lng` są generowane automatycznie.
+ Wszystkich zmian należy dokonywać w pliku `farlang.templ.m4`.
+ Jeżeli nie wiesz jak przetłumaczyć swoje zmiany na inne języki,
+ użyj angielskiej wersji z przedrostkiem `upd:`.
+
+
+#### x64 - przeprowadzenie poprawnej kompilacji dla x86 i x64
+
+1. DWORD_PTR, LONG_PTR, itd. są używane zamiast DWORD/long/itd. w następujących
+ przypadkach:
+
+ - potrzebne tam, gdzie wcześniej używano typu int/long/dword/or_any_other_non_pointer_type
+ i przypisano do niego wartość wskaźnika.
+ - ...
+ - ...
+
+
+> Przypomnienia, zadania, notatki powinny trafić do [systemu zgłaszania błędów](
https://bugs.farmanager.com).
diff --git a/CONTRIBUTING-RU.md b/CONTRIBUTING-RU.md
index 66578eab5..772d8b728 100644
--- a/CONTRIBUTING-RU.md
+++ b/CONTRIBUTING-RU.md
@@ -1,4 +1,7 @@
-### УЧАСТИЕ
+|[Английский](CONTRIBUTING.md)|[Польский](CONTRIBUTING-PL.md)|
+|-|-|
+
+### УЧАСТИЕ
> Этот документ поможет вам ознакомиться с нашим процессом разработки.
@@ -24,18 +27,23 @@
#### Сборка
-1. Для сборки в Visual Studio можно использовать проект для IDE или makefile.
- Пример для msbuild & vcxproj:
- `msbuild /property:Configuration=Release;platform=x64 far.vcxproj`
- Пример для nmake & makefile:
+```
+cd far
+```
+
+1. Для сборки в Visual Studio можно использовать проект для IDE или makefile.<br/>
+ Пример для msbuild & vcxproj:<br/>
+ `msbuild /property:Configuration=Release;platform=x64 far.vcxproj`<br/>
+ Пример для nmake & makefile:<br/>
`nmake /f makefile_vc`
-2. Для сборки в GCC можно использовать makefile.
- Пример для MinGW & makefile:
+2. Для сборки в GCC можно использовать makefile.<br/>
+ Пример для MinGW & makefile:<br/>
`mingw32-make -f makefile_gcc`
> Также см. комментарии в makefile_* для дополнительных параметров сборки.
+
#### Описание изменений - файл `changelog`
1. Все комментарии по внесенным изменениям пишутся в файл `changelog`.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index bef34bf48..bb494d5e7 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,4 +1,7 @@
-### CONTRIBUTING
+|[Polish](CONTRIBUTING-PL.md)|[Russian](CONTRIBUTING-RU.md)|
+|-|-|
+
+### CONTRIBUTING
> Sections below will help you get familiar with our development process.
@@ -30,15 +33,15 @@ to the project, please follow those guidelines:
cd far
```
-1. To compile with Visual Studio you can either use the IDE project or makefile.
- Example for msbuild & vcxproj:
- `msbuild /property:Configuration=Release;platform=x64 far.vcxproj`
- Example for nmake & makefile:
- `nmake /f makefile_vc`
+1. To compile with Visual Studio you can either use the IDE project or makefile.<br/>
+ Example for msbuild & vcxproj:<br/>
+ `msbuild /property:Configuration=Release;platform=x64 far.vcxproj`<br/>
+ Example for nmake & makefile:<br/>
+ `nmake /f makefile_vc`
-2. To compile with GCC you can use makefile.
- Example for MinGW & makefile:
- `mingw32-make -f makefile_gcc`
+2. To compile with GCC you can use makefile.<br/>
+ Example for MinGW & makefile:<br/>
+ `mingw32-make -f makefile_gcc`
> Also see comments in makefile_* for additional build parameters.
diff --git a/README-PL.md b/README-PL.md
new file mode 100644
index 000000000..21374137f
--- /dev/null
+++ b/README-PL.md
@@ -0,0 +1,58 @@
+|[Angielski](README.md)|[Rosyjski](README-RU.md)|
+|-|-|
+
+[![Header][logo-img]][logo-url]
+
+### Far Manager
+| | AppVeyor | Azure |
+|-|-|-|
+| VS | [![AppVeyor][VS-AppVeyor-img]][VS-AppVeyor-url] | [![Azure Pipelines][VS-Azure-img]][VS-Azure-url] |
+| GCC | [![AppVeyor][GCC-AppVeyor-img]][GCC-AppVeyor-url] | TBD |
+| Clang | [![AppVeyor][Clang-AppVeyor-img]][Clang-AppVeyor-url] | TBD |
+
+
+### Far Manager — czym jest?
+Far Manager to program do zarządzania plikami i archiwami w systemach operacyjnych Windows. Far Manager pracuje w trybie tekstowym i oferuje prosty oraz intuicyjny interfejs do przeprowadzania większości niezbędnych czynności:
+* podgląd plików i folderów;
+* edytowanie, kopiowanie i zmienianie nazw plików;
+* i wiele innych operacji.
+
+### Dostosowanie
+Far Manager posiada wielojęzykowy, łatwy do skonfigurowania interfejs. Nawigacja po systemie plików jest łatwiejsza dzięki użyciu grup sortowania i podświetlania kolorami.
+
+### Twoje zadanie - Twój sposób
+Funkcjonalność Far Manager jest znacznie rozszerzona o zewnętrzne moduły DLL — wtyczki (tworzone dzięki specjalnemu zestawowi interfejsów [API dla wtyczek](
https://api.farmanager.com/)). Dla przykładu: obsługa archiwów, klient FTP, panel tymczasowy oraz przeglądarka sieci są zaimplementowane jako wtyczki zawarte w standardowej dystrybucji Far.
+
+
+#### Forum wsparcia (po angielsku i rosyjsku)
+
https://enforum.farmanager.com/<br/>
+
https://forum.farmanager.com/
+
+#### Zgłaszanie błędów (po angielsku i rosyjsku)
+
https://bugs.farmanager.com/
+
+#### Lista mailingowa dla programistów (po angielsku)
+
https://groups.google.com/group/fardeven<br/>
+<
fard...@googlegroups.com>
+
+#### Lista mailingowa dla programistów (po rosyjsku)
+
https://groups.google.com/group/fardev<br/>
+<
far...@googlegroups.com>
+
+#### Lista mailingowa z poprawkami kodu
+
https://groups.google.com/group/farcommits<br/>
+<
farco...@googlegroups.com>
+
+#### Kod źródłowy
+
https://github.com/FarGroup/FarManager
+
+[logo-img]: ./logo.svg
+[logo-url]:
https://www.farmanager.com
+[VS-AppVeyor-img]:
https://ci.appveyor.com/api/projects/status/6pca73evwo3oxvr9?svg=true
+[VS-AppVeyor-url]:
https://ci.appveyor.com/project/FarGroup/farmanager/history
+[GCC-AppVeyor-img]:
https://ci.appveyor.com/api/projects/status/k7ln3edp8nt5aoay?svg=true
+[GCC-AppVeyor-url]:
https://ci.appveyor.com/project/FarGroup/farmanager-5lhsj/history
+[Clang-AppVeyor-img]:
https://ci.appveyor.com/api/projects/status/pvwnc6gc5tjlpmti?svg=true
+[Clang-AppVeyor-url]:
https://ci.appveyor.com/project/FarGroup/farmanager-tgu1s/history
+[VS-Azure-img]:
https://img.shields.io/azure-devops/build/FarGroup/66d0ddcf-a098-4b98-9470-1c90632c4ba3/1.svg?logo=azuredevops
+[VS-Azure-url]:
https://dev.azure.com/FarGroup/FarManager/_build?definitionId=1
diff --git a/README-RU.md b/README-RU.md
index 9a77702c3..dfe2a01ee 100644
--- a/README-RU.md
+++ b/README-RU.md
@@ -1,5 +1,15 @@
+|[Английский](README.md)|[Польский](README-PL.md)|
+|-|-|
+
+[![Header][logo-img]][logo-url]
+
### Far Manager
-
https://www.farmanager.com
+| | AppVeyor | Azure |
+|-|-|-|
+| VS | [![AppVeyor][VS-AppVeyor-img]][VS-AppVeyor-url] | [![Azure Pipelines][VS-Azure-img]][VS-Azure-url] |
+| GCC | [![AppVeyor][GCC-AppVeyor-img]][GCC-AppVeyor-url] | TBD |
+| Clang | [![AppVeyor][Clang-AppVeyor-img]][Clang-AppVeyor-url] | TBD |
+
### Far Manager — что это?
Far Manager — консольный файловый менеджер для операционных систем семейства Windows. Программа предоставляет удобный интерфейс пользователя для работы с файловыми системами (реальными и эмулированными) и файлами:
@@ -13,23 +23,36 @@ Far Manager имеет многоязычный, легко настраивае
### Под ваши задачи
Функциональность Far Manager существенно расширяется за счет внешних подключаемых DLL-модулей — плагинов (этому способствует набор специальных интерфейсов — [Plugins API](
https://api.farmanager.com/)). Например, работа с архивами, FTP-клиент, временная панель и просмотр сети реализованы с помощью плагинов, включенных в стандартную поставку Far Manager.
-### Форум поддержки
+
+#### Форум поддержки
+
https://enforum.farmanager.com/<br/>
https://forum.farmanager.com/
-### Баг трекер
+#### Баг трекер
https://bugs.farmanager.com/
-### Рассылка для разработчиков (русскоязычная)
-
https://groups.google.com/group/fardev
-<
far...@googlegroups.com>
-
-### Рассылка для разработчиков (англоязычная)
-
https://groups.google.com/group/fardeven
+#### Рассылка для разработчиков (англоязычная)
+
https://groups.google.com/group/fardeven<br/>
<
fard...@googlegroups.com>
-### Рассылка коммитов
-
https://groups.google.com/group/farcommits
+#### Рассылка для разработчиков (русскоязычная)
+
https://groups.google.com/group/fardev<br/>
+<
far...@googlegroups.com>
+
+#### Рассылка коммитов
+
https://groups.google.com/group/farcommits<br/>
<
farco...@googlegroups.com>
-### Исходный код
+#### Исходный код
https://github.com/FarGroup/FarManager
+
+[logo-img]: ./logo.svg
+[logo-url]:
https://www.farmanager.com
+[VS-AppVeyor-img]:
https://ci.appveyor.com/api/projects/status/6pca73evwo3oxvr9?svg=true
+[VS-AppVeyor-url]:
https://ci.appveyor.com/project/FarGroup/farmanager/history
+[GCC-AppVeyor-img]:
https://ci.appveyor.com/api/projects/status/k7ln3edp8nt5aoay?svg=true
+[GCC-AppVeyor-url]:
https://ci.appveyor.com/project/FarGroup/farmanager-5lhsj/history
+[Clang-AppVeyor-img]:
https://ci.appveyor.com/api/projects/status/pvwnc6gc5tjlpmti?svg=true
+[Clang-AppVeyor-url]:
https://ci.appveyor.com/project/FarGroup/farmanager-tgu1s/history
+[VS-Azure-img]:
https://img.shields.io/azure-devops/build/FarGroup/66d0ddcf-a098-4b98-9470-1c90632c4ba3/1.svg?logo=azuredevops
+[VS-Azure-url]:
https://dev.azure.com/FarGroup/FarManager/_build?definitionId=1
\ No newline at end of file
diff --git a/README.md b/README.md
index 89baadf43..de2456e71 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
+|[Polish](README-PL.md)|[Russian](README-RU.md)|
+|-|-|
+
[![Header][logo-img]][logo-url]
### Far Manager
@@ -22,22 +25,22 @@ The functionality of Far Manager is greatly extended by external DLL modules —
#### Support forum
-
https://enforum.farmanager.com/
+
https://enforum.farmanager.com/<br/>
https://forum.farmanager.com/
#### Bug tracker
https://bugs.farmanager.com/
#### Developers mailing list (english)
-
https://groups.google.com/group/fardeven
+
https://groups.google.com/group/fardeven<br/>
<
fard...@googlegroups.com>
#### Developers mailing list (russian)
-
https://groups.google.com/group/fardev
+
https://groups.google.com/group/fardev<br/>
<
far...@googlegroups.com>
#### Commits mailing list
-
https://groups.google.com/group/farcommits
+
https://groups.google.com/group/farcommits<br/>
<
farco...@googlegroups.com>
#### Source code