search

ProjektyUstaw / Ustawy-o-PIT

919 stars 45 forks source link

Przeniesienie PDF-ów do osobnego katalogu #119

Closed ctomczyk closed 1 year ago

ctomczyk commented 1 year ago

Sugeruję zmianę struktury plików i przeniesienie PDF-ów do katalogu wersje pdf.

Pliki PDF w zasadzie to generowałbym bezpośrednio z plików tekstowych (markdown -> PDF).

Plus, automatyczna publikacja pod określoną domenę.

pawelwod commented 1 year ago

Pliki PDF można robić przy kolejnych wersjach jako artefakty do releasu albo paczki.

ctomczyk commented 1 year ago

Pliki PDF można robić przy kolejnych wersjach jako artefakty do releasu albo paczki.

Można i nawet byłoby wskazane. Niemniej jednak pliki typu "dist" (PDF tutaj) rozważyłbym pozostawienie w repozytorium.

pawelwod commented 1 year ago

Niemniej jednak pliki typu "dist" (PDF tutaj) rozważyłbym pozostawienie w repozytorium.

A tak z ciekawości, dlaczego?

ctomczyk commented 1 year ago

Niemniej jednak pliki typu "dist" (PDF tutaj) rozważyłbym pozostawienie w repozytorium.

A tak z ciekawości, dlaczego?

Jak hosting wygaśnie, to na GitHubie ciągle będą dostępne. ;-)

pawelwod commented 1 year ago

Ja właśnie mówię o załączaniu do githuba tak jak robisz release i możesz binarki dołączyć do releasu. Pewnie da się automatycznie też robić (tutaj niech ktoś bardzie obeznanny się wypowie jak). W ten sposób repo nie będzie puchło a kolejne wersje będą dostępne jak ktoś chce PDFy oglądać.

piotr-calus commented 1 year ago

Pliki PDF można robić przy kolejnych wersjach jako artefakty do releasu albo paczki.

O ile nie ma jakiś szczególnych wymagań, ta propozycja wydaje się najlepszym rozwiązaniem. W przeciwnym razie, osoby chcące pobrać repozytorium i pracować z tekstem lokalnie, np. bez połączenia z internetem, będą zmuszone do przechowywania na dysku wszystkich kolejnych wersji PDF lub ograniczenia dostępu do historii (z użyciem git fetch --depth).

Umieszczanie wszelkich wygenerowanych plików (w tym przypadku PDF) w Wydaniach (Releases) jest uznawane za przejaw Dobrych Praktych.

ctomczyk commented 1 year ago

W przeciwnym razie, osoby chcące pobrać repozytorium i pracować z tekstem lokalnie, np. bez połączenia z internetem, będą zmuszone do przechowywania na dysku wszystkich kolejnych wersji PDF lub ograniczenia dostępu do historii (z użyciem git fetch --depth).

No raczej nie będą mieli wszystkich wersji. Jedynie tą, która jest aktualnie w repozytorium.

MacDada commented 1 year ago

No raczej nie będą mieli wszystkich wersji. Jedynie tą, która jest aktualnie w repozytorium.

@ctomczyk git trzyma lokalnie całą historię repo -> a więc wszystkie rewizje, wszystkie wersje historyczne pliku

ctomczyk commented 1 year ago

No raczej nie będą mieli wszystkich wersji. Jedynie tą, która jest aktualnie w repozytorium.

@ctomczyk git trzyma lokalnie całą historię repo -> a więc wszystkie rewizje, wszystkie wersje historyczne pliku

@MacDada Słuszna uwaga. Źle się wyraziłem.

devcharted commented 1 year ago

Pliki PDF można robić przy kolejnych wersjach jako artefakty do releasu albo paczki.

O ile nie ma jakiś szczególnych wymagań, ta propozycja wydaje się najlepszym rozwiązaniem. W przeciwnym razie, osoby chcące pobrać repozytorium i pracować z tekstem lokalnie, np. bez połączenia z internetem, będą zmuszone do przechowywania na dysku wszystkich kolejnych wersji PDF lub ograniczenia dostępu do historii (z użyciem git fetch --depth).

Umieszczanie wszelkich wygenerowanych plików (w tym przypadku PDF) w Wydaniach (Releases) jest uznawane za przejaw Dobrych Praktych.

Wypadałoby zrobić workflow releasowy który zbuduje pdf i otaguje wersję.

MacDada commented 1 year ago

Docelowo PDFy będą generowane automatycznie. Zamykam więc ten wątek, bo obędzie się bez przenoszenia PDFów.