Initial commit

1 files changed, 87 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..33ea965
--- /dev/null
+++ b/README.md
@@ -0,0 +1,87 @@
+# Puzzle do ewangelizacji
+
+W tym repozytorium znajdują się projekty puzzli sprzedawanych przeze mnie w
+ramach mojej JDG (Jednoosobowa Działalnośc Gospodarcza).
+
+## Produkcja
+
+Jeśli chcesz wyprodukować podobne puzzle bazując na tym projekcie, możesz
+poprosić o ofertę producenta [Puzzle4U](mailto:biuro@puzzle4u.pl), który
+wydrukował pierwszą partię układanek.  Znajdujące się w repozytorium pliki PDF w
+formacie CMYK są dostosowane do oczekiwań tego producenta dla układanek
+500-elementowych — w przypadku innych producentów może być potrzeba dostosować
+projekt do ich technologii, używanych formatów itd.
+
+Zanim wydrukujesz swoją partię puzzli na sprzedaż, nie zapomnij zastąpić na
+projekcie wieczka kodu kreskowego i adresu pod "wyprodukowano dla:".  Jeśli
+wypuszczasz puzzle na rynek bez kodu kreskowego (który nie jest wymagany
+prawnie), prawdopodobnie będziesz chciał(a) dodać na wieczku jakąś inną
+informację umożliwiającą identyfikację produktu (wymóg prawny dla zabawek).
+
+W kwestii kruczków prawnych, warto też upewnić się, że producent spełnił wymogi
+do oznaczenia puzzli znakiem "CE" (wymaganym dla zabawek wprowadzanych na rynek
+w UE).
+
+## Wykorzystywane programy
+
+Do przygotowania projektów w tym repozytorium wykorzystano wyłącznie wolne
+oprogramowanie.
+
+### graficzne
+
+- [Inkscape](https://inkscape.org/)
+- [Scribus](https://wiki.scribus.net/canvas/Scribus)
+
+### terminalowe
+
+- [GhostScript](https://www.ghostscript.com/)
+- komenda `convert` z pakietu [ImageMagick](https://imagemagick.org/index.php)
+- [GNU Barcode](https://www.gnu.org/software/barcode/)
+
+## Workflow przygotowania projektu
+
+Do konwersji pojedynczych obrazów do przestrzeni kolorystycznej CMYK (na której
+zwykle pracują drukarnie) można wykorzystać komendę `convert`.
+
+``` shell-script
+  # Plik docelowy może być PDFem, JPGiem lub TIFFem.
+  convert -colorspace cmyk /path/to/picture.jpg /path/to/picture-CMYK.pdf
+```
+
+Zmiany w projektach wieczek najłatwiej jest wprowadzać w plikach .svg.  Tutaj
+użyty był Inkscape.  Wyeksportowane pliki .pdf były konwertowane do CMYK za
+pomocą GhostScripta.
+
+```
+guix shell ghostscript -- gs \
+    -o ./plik-CMYK.pdf  \
+    -sDEVICE=pdfwrite \
+    -sProcessColorModel=DeviceCMYK \
+    -sColorConversionStrategy=CMYK \
+    -sColorConversionStrategyForImages=CMYK \
+    ./plik-RGB.pdf
+```
+
+W podglądzie, kolory obrazów w tak przygotowanych dokumentach z GhostScripta
+zdawały się być nieadekwatne.  Z tego powodu w znajdujących się w tym
+repozytorium PDFach z projektami wieczek sam obrazek został podmieniony na
+wersję przekonwertowaną wcześniej za pomocą ImageMagick do CMYK.  Do podmianki
+został wykorzystany Scribus.  Za pomocą Scribusa przygotowane zostały również
+PDFy z dodatkową siatką wieczka na osobnych warstwach (również wymóg
+producenta).
+
+Do generowania kodów kreskowych sprawdza się GNU Barcode.
+
+``` shell-script
+# Można ale nie trzeba dodawać cyfry kontrolnej na końcu ciągu — GNU barcode
+# jest w stanie sam ją wyliczyć
+barcode -S -b 590606340730 -e ean -o /path/to/barcode.svg
+```
+
+## Warunki kopiowania
+
+(C) All rights reversed
+
+Projekty są dostępne na licencji [Creative Commos Zero
+v1.0](https://creativecommons.org/publicdomain/zero/1.0/legalcode.pl).
+Repozytorium zgodne ze specyfikacją [REUSE](https://reuse.software/) v3.0.