summaryrefslogtreecommitdiff
path: root/http
diff options
context:
space:
mode:
authoremkael <emkael@tlen.pl>2019-05-31 18:22:53 +0200
committeremkael <emkael@tlen.pl>2019-05-31 18:22:53 +0200
commite7f7ae45b7dfd45a8b2ac0603a501273a5f10b2d (patch)
tree5bbbf1145fb241d8b2b805c976e5e38e41846bc7 /http
parent6ddd1c437c56f45c840969ec55361b8d642885a1 (diff)
FAQ
Diffstat (limited to 'http')
-rw-r--r--http/dealconvert.js1
-rw-r--r--http/index.html53
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">