Some code cleaning + clarifying (TODO: work on variables names)
[vchess.git] / views / index.pug
index d658e7e..ba5393c 100644 (file)
@@ -7,30 +7,97 @@ block content
        .container#indexPage
                .row
                        .col-sm-12
-                               h1.text-center Welcome to v[ariant] chess club !
-                               h2.help.text-center(onClick="document.getElementById('modal-control').checked=true") Help ?
-                               input#modal-control.modal(type="checkbox")
+                               h1.text-center.main-title Welcome to v[ariant] chess club !
+                               h2.text-center
+                                       span.help(onClick="document.getElementById('modal-help').checked=true")
+                                               | Help ? 
+                                       a(href="/demo.webm") Demo !
+                               input#modal-help.modal(type="checkbox")
                                div(role="dialog")
-                                       .card
-                                               label.modal-close(for="modal-control")
-                                               h3.blue.section Modes
-                                               p.section.
-                                                       Each variant page offers two modes: against a human or computer opponent,
-                                                       which is here to help learning the rules.
+                                       #help.card
+                                               label.modal-close(for="modal-help")
+                                               h3.blue.section Tips
+                                               p.section
+                                                       span.conditional-jump
+                                                               | On a variant page, read the rules by clicking on the title
+                                                               | "<Variant> rules". 
+                                                       span.conditional-jump
+                                                               | Try playing against a human: click the leftmost "new game" button :) 
+                                                       | ...then, while waiting you can play against a (rather weak) bot
+                                                       | or a friend.
+                                               // TODO? On the index page, try typing the first letters of a variant.
                                                h3.blue.section Comments
                                                p.section.
                                                        All games start with a random assymetric position. #[br]
                                                        Games are untimed, and played anonymously. #[br]
                                                        No chat, to rather focus on the moves :)
-                                               h3.purple.section Bug report
-                                               p.section.
-                                                       If you find a bug in a game, please follow this procedure: #[br]
-                                                       1. stop playing (click on the resign button); #[br]
-                                                       2. click on the PGN to download it; #[br]
-                                                       3. send an email to #[a(href="mailto:contact@vchess.club?subject=Bug report") this address],
-                                                       describing the situation (what is expected vs. what is observed),
-                                                       with the PGN attached :)#[br]
-                                                       Thank you!
+                                               h3.red.section Bug report
+                                               p.section
+                                                       | If you find a bug in a game, please follow this procedure: #[br]
+                                                       | 1. stop playing: click on the resign button; #[br]
+                                                       | 2. click on the PGN to download it; #[br]
+                                                       | 3. send an email to 
+                                                       a(href="mailto:contact@vchess.club?subject=[vchess.club] bug report")
+                                                               | contact@vchess.club 
+                                                       | with relevant comments and the PGN attached. Thank you!
+                               input#modal-b4welcome.modal(type="checkbox")
+                               div(role="dialog")
+                                       #b4welcome.card.text-center
+                                               label.modal-close(for="modal-b4welcome")
+                                               h3.blue.section First visit?
+                                               p Please 
+                                                       span.read-this(@click="showWelcomeMsg") read this
+                                                       span  before playing ☺
+                               input#modal-welcome.modal(type="checkbox")
+                               div(role="dialog")
+                                       #welcome.card.text-center
+                                               label.modal-close(for="modal-welcome")
+                                               h3.blue.section Welcome to vchess.club!
+                                               .section
+                                                       p A fun place to play chess variants in real time!
+                                                       p But wait... what is a chess variant?
+                                                       img(src="/images/Hexagonal_chess.svg")
+                                                       p.
+                                                               As suggested by the picture, a variant setup generally
+                                                               looks more or less like a chessboard with regular pieces
+                                                               (otherwise it's no longer a variant but a whole new game!).
+                                                       p.emphasis However...
+                                                       p Each variant has its own new rules, which can involve
+                                                       table.list-table
+                                                               tbody
+                                                                       tr
+                                                                               td * different pieces movements
+                                                                       tr
+                                                                               td * different chessboard(s)
+                                                                       tr
+                                                                               td * new pieces
+                                                                       tr
+                                                                               td * moves side effects
+                                                                       tr
+                                                                               td ...and so on
+                                               .section
+                                                       p.
+                                                               Example: imagine that a capture is an atomic explosion, wiping all
+                                                               adjacent squares – except the pawns, which as cockroaches can
+                                                               resist this kind of event.
+                                                       p Also state a goal: make the opponent's king explode.
+                                                       p → Congrats, you defined Atomic chess! (Playable here)
+                                               .section
+                                                       p.emphasis OK, this all sounds interesting, but why would that be fun?
+                                                       p.
+                                                               Because all games here start with a random setup: no more boring
+                                                               openings memorization, you have to rely on your chess skills only :)
+                                                       p Moreover, I claim that the chosen variants here are fun to play :P
+                                                       -
+                                                               var wikipediaUrl = "https://en.wikipedia.org/wiki/" +
+                                                                       "List_of_chess_variants#/media/File:Hexagonal_chess.svg";
+                                                       p.
+                                                               For informations about hundreds (if not thousands!) of variants, you
+                                                                       can visit the excellent
+                                                                       #[a(href="https://www.chessvariants.com/") chessvariants] website.
+                                               p.disable-msg(@click="markAsVisited")
+                                                       | Click here to not show this message next time
+                                               p.smallfont Image credit: #[a(href=wikipediaUrl) Wikipedia]
                .row
                        my-variant-summary(
                                v-for="(v,idx) in sortedCounts",
@@ -42,6 +109,7 @@ block javascripts
        script.
                const variantArray = !{JSON.stringify(variantArray)};
                //JSON.parse("!{variantArray}".replace(/\"/g,'"'));
+       script(src="/javascripts/utils/misc.js")
        script(src="/javascripts/utils/socket_url.js")
        script(src="/javascripts/components/variantSummary.js")
        script(src="/javascripts/index.js")