Współtwórz on Ansel

The pact

Mon, 27 Jul 2026 00:00:00 +0000

Free software runs on two one-way transactions. Users take the product without giving anything back, because three centuries of market taught us that a thing endlessly downloadable has no price. Developers decide without answering to anyone, because the license says they owe nothing — not even an explanation. One side takes without paying, the other rules without accounting. These are not two problems: they are the same problem, seen from both ends, and most of what is wrong with free software grows on it.

Scope

Mon, 27 Jul 2026 00:00:00 +0000

Knowing the audience is the first step of design, and declaring the scope is the first step of governance: every request, bug report and contribution is measured against this page. There are two honest ways to criticize the project. Holding it to what this page promises — that critique is always receivable, and the project cannot dismiss it without contradicting itself. Measuring it against a goal it never adopted — that is a wish, receivable as a wish and refusable as one. This page exists so everyone can tell which is which.

Code of conduct

Tue, 28 Jul 2026 00:00:00 +0000

This code protects two groups from two dangers. It protects users — including the non-technical, the non-English-speaking, the beginner who wandered in — from being treated as failed programmers. And it protects the people who do the work from the pressure of a crowd that outnumbers them a thousand to one. Most codes of conduct only look in one direction; this one refuses to choose, because the project has seen what each direction costs.

A culture of problem solving

Mon, 27 Jul 2026 00:00:00 +0000

Everything in open source is public: the code, the bugs, the requests, the discussion. Everyone can chime in — which is a strength only if the conversation is disciplined, and a slow-motion disaster otherwise. This page is the discipline. It is not etiquette: every rule here exists because its violation has a measurable cost in wasted work, and the bug-reporting protocol and design protocol both build on it.

For background, see The designer and the drilling machine and Design by committee will not save FLOSS .

Reporting bugs

Mon, 27 Jul 2026 00:00:00 +0000

A bug report is testimony: what you did, what happened, what you expected. That is all the project asks of you — the translation into causes, diagnoses and fixes is our work, not yours. You will never be blamed for not knowing computers, for imperfect English, or for a report that turns out to be a documentation problem: a user who cannot follow a technical instruction has found a design or documentation defect, not committed a personal failing (code of conduct).

Projektowanie Ansela

Sun, 14 Jul 2024 00:00:00 +0000

Ansel is designed, not hacked. The difference is a process: hacking optimizes for the pleasure of writing code, design optimizes for the problem being solved — and for what the solution will cost to maintain (technical debt ) long after the fun is gone. This page is that process. Pull requests that bypass it will be refused, whatever their technical quality: it is the pact applied to code.

Nominal workflows

Sun, 14 Jul 2024 00:00:00 +0000

What Ansel is, who it serves and what it refuses is declared in Scope; this page gives the background — why digital photography software went wrong — and the concrete workflows the tool is optimized for. Everything here is reference material for the design protocol: a proposal is evaluated against these workflows, not against the sum of everyone’s habits.

Context

Fotografia cyfrowa upowszechniła się w latach 2000., ponieważ umożliwiła szybszy przepływ pracy i pozwoliła uzyskiwać natychmiastowe wyniki w porównaniu z tradycyjnym przepływem pracy opartym na filmie i ciemni. Wprowadziła jednak wiele nowych problemów.

Organizacja projektu

Sun, 14 Jul 2024 00:00:00 +0000

The project is run by the maintainer, who balances developing and maintaining the software with the rest of a life. This calls for low-overhead project management strategies, relying on cloud-based collaborative tools.

Działy

Rozwój oprogramowania

Rozwój odbywa się na Githubie ,

Feature requests are not taken from users at this point. Users are consulted by the developer regarding their needs when a (re)design project is started. This is to prevent disruptive inputs at random times that would only slow-down the opened projects. Consultations reach beyond the forum and chat regulars — through surveys when the stakes warrant it — because the people who show up in project spaces are a biased sample of the people who use the tool, and silence is not satisfaction: those who left or never came have needs too, and they are precisely the ones the loudest channels never carry.

Segregacja zgłoszeń

Mon, 15 Jul 2024 00:00:00 +0000

Ta strona jest przeznaczona dla osób pomagających w segregacji zgłoszeń w systemie śledzenia zgłoszeń na Githubie.

Preamble

Każdy projekt ma ograniczone zasoby, różnica między projektami polega na progu.
Każdy projekt powinien mieć jasno określone cele. Dla Ansela jest to zarządzanie, edytowanie i eksportowanie kolekcji obrazów RAW na komputerze stacjonarnym przez użytkownika końcowego, który nie korzysta z wiersza poleceń, ale stawia wizualną jakość obrazu ponad wszystko inne.
Każdy projekt ma narzut, czyli działania wymagane, aby osiągnąć cele, choć same w sobie nie są celem i dlatego powinny pozostać minimalne. Dla Ansela jest to utrzymanie strony internetowej, dokumentacji, serwerów, pakietów budowanych co noc, porządkowanie kodu, debugowanie, testy regresji, wsparcie dla wielu systemów operacyjnych, segregacja zgłoszeń itd.
Cele i narzut należy wyrażać w kategoriach zadań do wykonania, aby rozwiązać problemy (zgłoszenia). Jeśli nie ma problemu do rozwiązania, to nie ma pracy do wykonania: status quo też jest świetne, nie twórz pracy dla samej pracy.
z powodu ograniczenia zasobów zadania muszą być uporządkowane według ich priorytetu.

Poniższy dokument ma na celu zdefiniowanie tego priorytetu.

Styl kodowania

Sun, 14 Jul 2024 00:00:00 +0000

Wartości

Jeśli coś nie jest zepsute, nie naprawiaj tego

Zbyt wiele w „projektowaniu" Darktable zaczynało się od „fajnie by było, gdybyśmy mogli…". Powiem Ci, co jest fajne: jak najszybsze powieszenie Twoich dobrych zdjęć na ścianie. Sztuki wizualne nie są sztuką wykonawczą (jak muzyka czy teatr), więc liczy się tylko rezultat. Wszystko, co następuje wcześniej, to narzut, który zwykle chcesz utrzymać na minimalnym poziomie. Nie znaczy to, że proces sam w sobie nie może sprawiać przyjemności. Aby jednak czerpać przyjemność z procesu, musisz opanować swoje narzędzia i nagiąć je do swojej woli, w przeciwnym razie tylko z nimi walczysz, a cały proces sprowadza się do frustracji. Problem w tym, że „projektowanie" Darktable wkłada zbyt wiele wysiłku w bycie innym dla samej odmienności.

Dokumentowanie Ansel

Mon, 13 Oct 2025 00:00:00 +0000

Wprowadzenie

Istnieją różne sposoby dostępu do informacji:

(chrono)logiczny, jak czytanie strona po stronie, wiersz po wierszu, aż dotrzesz do końca publikacji,
tematyczny, jak przejście do spisu treści i skok wprost do części, która Cię interesuje, pod warunkiem, że treść jest podzielona na sensowne jednostki treści,
poprzeczny, jak podążanie za sekcją „powiązane wpisy" opartą na podobieństwie treści (definiowanym ręcznie, za pomocą tagów i słów kluczowych, lub wyuczonym przez analizę tematyczną AI), lub za jawnymi odsyłaczami. Na przykład większość witryn ma archiwa wymieniające wszystkie strony mające określony tag/słowo kluczowe, książki mają glosariusze.
oparty na podpowiedziach, jak przedstawienie bibliografii bardziej pogłębionych publikacji lub sekcji „więcej informacji" na końcu treści, albo antycypowanie późniejszej treści,
oparty na źródłach, podążanie za odsyłaczami (zwykle przypisami dolnymi lub bocznymi) do publikacji, z których wydobyto informację, głównie w celach weryfikacyjnych,
wyszukiwanie informacji, czyli wyszukiwarka.

Musisz wspierać je wszystkie naraz, ponieważ są komplementarne, a najlepszy w danym kontekście zależy od początkowej wiedzy i potrzeb czytelnika. Żaden z tych sposobów nie jest lepszy od pozostałych. Oznacza to, że trzeba dokonać sporego „upychania słów kluczowych" w swoim tekście, aby zapewnić, że oparta na słowach kluczowych analiza treści oraz wyszukiwanie informacji według słów kluczowych będą działać zgodnie z oczekiwaniami.

Tłumaczenie

Mon, 15 Jul 2024 00:00:00 +0000

Ansel używa Gettext do tłumaczenia wszystkich części projektu:

Aplikacji (napisanej w C),
Strony internetowej (szablony Hugo i treść w Markdown),
Dokumentacji/podręcznika użytkownika, dołączonego do strony jako moduł (również szablony Hugo i treść w Markdown).

Dzięki temu ten sam przepływ pracy może służyć do tłumaczenia wszystkich plików, a niektóre przetłumaczone ciągi znaków można współdzielić (na przykład przetłumaczone elementy interfejsu z aplikacji można wstawić bezpośrednio do dokumentacji).

Organizacja plików tłumaczeń

Kod źródłowy strony internetowej, dokumentacji i oprogramowania zawiera bezpośredni podfolder po/, który zawiera:

Przekaż zdjęcia do odszumiacza AI

Sat, 18 Jul 2026 00:00:00 +0000

Ansel zawiera neuronowy odszumiacz raw (moduł rawdenoiseai), który różni się od uniwersalnych odszumiaczy AI: jest trenowany na niedemozaikowanych danych matrycy, tak blisko rzeczywistego odczytu matrycy, jak pozwala na to plik raw, i działa dokładnie w tym samym punkcie potoku (pipeline) — przed balansem bieli, korekcją aberracji chromatycznej i demozaikowaniem — więc każdy późniejszy etap dalej w potoku dziedziczy czyste dane. Jeden zestaw wag obejmuje każdy aparat, dla którego Ansel ma profil szumu, zarówno Bayer, jak i X-Trans.

Zautomatyzowane procesy

Thu, 01 May 2025 00:00:00 +0000

Ponieważ Ansel jest w większości przedsięwzięciem jednoosobowym, wszystko, co można było zautomatyzować, zostało zautomatyzowane. Ta strona śledzi wszystko, co w przyszłości powinno być utrzymywane, oraz gdzie.

Oprogramowanie

Kompilacje nocne

Kompilacje nocne przygotowują skompilowaną i spakowaną wersję oprogramowania, każdej nocy o 6:00 UTC, dla:

Linux ,
Windows ,
MacOS jest obecnie wyłączony.

Najnowsze pliki binarne są automatycznie dodawane do zasobów pre-release , są publikowane na kanale Matrix , aby użytkownicy mogli subskrybować aktualizacje, oraz można je pobrać poprzez (stale aktualne) trwałe odnośniki pod adresem:

Demokracja

Mon, 13 Oct 2025 00:00:00 +0000

Ansel powinien być prowadzony demokratycznie i sprawiedliwie wobec wszystkich zaangażowanych.

Definiowanie organizacji spółdzielczej wykraczającej poza kod open source

Zakładamy, że deweloperzy i użytkownicy, którzy tu trafiają, dzielą wspólny interes: chcą swobody w tym, jak edytują swoje zdjęcia, teraz i w przyszłości. To znaczy:

posiadania wystarczającej kontroli technicznej nad treścią i właściwościami swoich obrazów,
bycia wolnym od kapitalistów, którzy mogą:
- podnosić cenę aplikacji wyłącznie na korzyść akcjonariuszy,
- eksplorować zdjęcia klientów w celu trenowania modeli AI bez zgody,
- wygaszać aplikacje bez udostępnienia kodu źródłowego,
posiadania prawa do decydowania o kształcie i realizacji owej swobody.

DNA Ansela jest bardziej techniczne i szczegółowe niż w większości edytorów zdjęć RAW, przy jednoczesnym podkreślaniu przyjazności dla użytkownika tam, gdzie to możliwe, głównie w typowych zadaniach zorientowanych na komputer stacjonarny (interakcje z urządzeniami wejściowymi i plikami, paradygmaty GUI itp.). Ansel nie jest Darktable ani ART , ponieważ jego wizja tego, jakim powinno być dobre oprogramowanie do retuszu obrazów, jest całkiem inna.

Strony internetowe

Thu, 01 May 2025 00:00:00 +0000

Strona Ansel jest zbudowana przy użyciu Hugo 0.146 . Jest to generator statycznych stron internetowych, który pozwala budować bardzo szybkie strony z plików Markdown. Dla Ansel stworzono niestandardowy szablon oraz wiele niestandardowych shortcode’ów. Najpierw musisz zainstalować rozszerzoną wersję Hugo na swoim komputerze, choć drobne zmiany można wprowadzać bezpośrednio w plikach Markdown bez budowania całej strony.

Pobieranie kodu źródłowego

Ta strona

1$ git clone https://github.com/aurelienpierreeng/ansel-website
2# Stored for example in /home/user/dev/ansel-website
3$ cd ansel-website
4$ sh build-modules.sh

Dokumentacja Ansel

Dokumentacja Ansel jest ważną częścią strony Ansel, ale ponieważ podlega innej licencji i jest forkiem dtdocs na licencji GNU/GPL, nie może znajdować się w tym repozytorium. Chcemy edytować obie jako pakiet, ale musimy mieć możliwość commitowania ich osobno do różnych repozytoriów. Oto rozwiązanie.