diff options
| -rw-r--r-- | http/dealconvert.js | 1 | ||||
| -rw-r--r-- | http/index.html | 53 |
2 files changed, 54 insertions, 0 deletions
diff --git a/http/dealconvert.js b/http/dealconvert.js index 3e5ea85..ff25444 100644 --- a/http/dealconvert.js +++ b/http/dealconvert.js @@ -1,4 +1,5 @@ $(document).ready(function() { + $('a.faq-btn').popover(); $('input[name="output"]').change(function() { if ($('input[name="output"]:checked').length > 0) { $('#submit-btn').removeAttr('disabled'); diff --git a/http/index.html b/http/index.html index faebaff..fb97c5e 100644 --- a/http/index.html +++ b/http/index.html @@ -1,6 +1,7 @@ <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> <title>DealConvert by mkl</title> <script src="https://code.jquery.com/jquery-3.4.1.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js" integrity="sha384-UO2eT0CpHqdSJQ6hJty5KVphtPhzWj9WO1clHTMGa3JDZwrnQq4sF86dIHNDz0W1" crossorigin="anonymous"></script> @@ -11,10 +12,62 @@ <body> <div class="container"> <div class="page-header"> + <a href="#" class="faq-btn btn btn-info float-right" data-toggle="collapse" data-trigger="hover" data-content="FAQ" data-placement="bottom" data-target="#faq">ⓘ</a> <h1>Konwerter rozdań</h1> <p><a href="https://github.com/emkael/deal-convert/">Deal-convert</a>, autor: <a href="https://emkael.info/">Michał Klichowicz</a></p> </div> </div> + <div class="container collapse mb-3" id="faq"> + <div class="card"> + <div class="card-header bg-info text-white"> + Pytania i odpowiedzi + </div> + <div class="card-body"> + <dl> + <dt>Czemu konwerter mi nie zadziałał?</dt> + <dd> + Nie wiem, prześlij mi problemowy plik z opisem błędu <a href="mailto:klichowicz.michal@gmail.com">mailem</a> albo od razu <a href="https://github.com/emkael/deal-convert/issues/">do systemu śledzenia błędów</a>.<br /> + Pliki wszystkich formatów wygenerowane poprawnie i z ciągłą numeracją rozdań od 1 (np. wygenerowane przez BigDeala) powinny konwertować się we wszystkie strony bez problemu. Nie wszystkie formaty plików są udokumentowane w sposób pozwalający obsłużyć je kompleksowo, na przykład formaty <code>DUP</code> i <code>DLM</code> (stary i nowy format Duplimate) zawierają dużo opcji, które konwerter ignoruje, a czasami wręcz wprost przyznaje, że nie wie, jak się zachować. Jeśli masz jakieś informacje, które mogłyby usprawnić wsparcie takich formatów, pisz jak wyżej. + </dd> + <dt>Czemu konwerter nie wspiera formatu X?</dt> + <dd> + Bo nie obsługiwał go BigDeal w momencie, kiedy konwerter powstawał.<br /> + Wyjątkiem są "ślepe" formaty Duplimate, które były wyodrębione w BigDeal, ale nie są obsługiwane, a różnią się od "jawnych" formatów Duplimate tylko określonymi opcjami. Oba te formaty są prawidłowo importowane, konwerter zapisuje jednak tylko do plików "jawnych".<br /> + W przyszłości rozważane jest wsparcie dla formatu <code>LIN</code>. Jeśli chcesz obsługi jakiegoś innego formatu, pisz jak wyżej. + </dd> + <dt>Czemu w pliku PBN nie ma analizy w widne?</dt> + <dd>Nie ma, pracuję nad tym. Możesz ją sobie łatwo (i szybko!) wykonać przy pomocy <a href="https://github.com/emkael/bcdd/">BCDD</a>.</dd> + <dt>Czemu dostaję mnóstwo ostrzeżeń <kbd>.xxx file format assumes consequent deal numbers from 1</kbd>?</dt> + <dd>Niektóre formaty nie przechowują numerów rozdań. W takich sytuacjach, zarówno przy imporcie, jak i eksporcie, konwerter zakłada, że rozdania mają kolejne numery, od 1. Może to doprowadzić do zmiany numeracji rozdań, jeśli oryginalny plik nie zaczynał się od rozdania nr 1 albo numeracja zawierała dziury.</dd> + <dt>Czemu mój PBN nie chce się otworzyć w BigDealu?</dt> + <dd> + BigDeal zakłada, że numeracja rozdań w pliku PBN zaczyna się od 1. Możliwy jest eksport do PBN plików, które nie spełniają tego warunku (np. formaty Duplimate robią tak powszechnie).<br /> + Jest łatwy sposób, aby poradzić sobie z tym problemem: + <ol> + <li>Wyeksportować rozkłady do plik <code>DLM</code>.</li> + <li>Odnaleźć w pliku <code>DLM</code> linię <kbd>From board=X</kbd>.</li> + <li>Zmienić ją na <kbd>From board=1</kbd>.</li> + <li>Tak spreparowany plik skonwertować do <code>PBN</code>.</li> + <li>Prawdopodobnie konwerter zgłosi błąd sumy kontrolnej, można go ignorować, jeśli nie chce się używać pośredniego pliku <code>DLM</code>.</li> + <li>Wynikowy plik <code>PBN</code> rozpoczyna się od rozdania nr 1 i jest uzupełniony rozdaniami z 13-kartowymi kolorami w każdej z rąk.</li> + </ol> + <dt>Czy to bezpieczne, tak wysyłać rozkłady do Internetu?</dt> + <dd> + Doskonałe pytanie!<br /> + Nie jestem oczywiście w stanie zapewnić, że przesyłane w ten sposób rozkłady są w 100% odporne na wyciek, ale ze strony konwertera: + <ul> + <li>zapewniam szyfrowane połączenie HTTPS</li> + <li>udostępniam <a href="https://github.com/emkael/deal-convert/">kod źródłowy całości narzędzia</a></li> + <li>nie przechowuję oryginalnych plików wejściowych na serwerze</li> + <li>pliki wynikowe przechowuję przez <strong>15 minut</strong> od momentu wygenerowania</li> + <li>pliki wynikowe dostępne są tylko w tej samej sesji przeglądarki, w której zostały wygenerowane</li> + </ul> + Ogólnie, jeśli zachować elementarne środki ostrożności, tj. niekorzystanie z konwertera w niezaufanych sieciach oraz z niezaufanych komputerów, konwerter niesie dużo mniejsze ryzyko niż np. zostawienie rozkładów na pamięci przenośnej na sali gry czy wysyłanie ich pocztą elektroniczną. + </dd> + </dl> + </div> + </div> + </div> <div class="container"> <form id="converter-input"> <div class="form-group"> |