How do I add a replayer to my post?

Question

How do I add the replayer to the post initially, and what additional features can I take advantage of?

NOTE: if you have a question about why the replayer isn't working for the PGN in your post, it's better to ask a new Meta question instead of posting an answer here.

Answer 1

This post is a work in progress, please feel free to add or embellish...

Most of the details here come from balpha's post.

Background

There are two basic ways to use the replayer: first, you can use the replayer to simply display a FEN position, and second, you can post a pgn game and then others can click through the moves.

The basic idea is that you post the pgn or FEN in a code block. In order to create a code block, indent the pgn or FEN by four spaces. As a shortcut, you can either click the editor's "Preformatted text" button, or press Ctrl-K.

Position

In order to simply show a position, just post the FEN string in a code block. It will automatically be converted into a diagram.

Example:

r1br2k1/pp3ppp/2n2n2/1Bb3B1/8/2p2N2/PPP2PPP/R4RK1 w - - 1 13

Is converted into:

          

Entire Game

In order to display an entire game, you can post the entire pgn in a code block. Most chess software allows you to copy/paste the pgn from a game, but wikipedia also has a good summary if you want to just type the pgn yourself.

There is one caveat - the pgn you post must include a FEN header.

[FEN "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"]

This was done in order to create an "opt-in" experience for the replayers (i.e. only display a replayer if you actively choose to have one), but this is open for debate.

As a shortcut, if you are starting from the start position, you can just include a blank FEN header:

[FEN ""]

Additional Features

It is possible to enter entire variations and annotations for your games as well. If you simply copy/paste a pgn file from your external program, it will usually work correctly (after you add a FEN string). In order to enter variations, you can use parentheses for the variation moves. You can enter comments in curly braces too:

1. e4 e5 2. Nf3 Nc6 (2... Nf6 {Nf6 instead of Nc6 is called the Petroff Defense})

Variations can be nested as well.

Answer 2

Anyone got a clue why the (3^rd) replayer there is not working ?

I tried fiddling a lot with it, the position looks fine (if I remove the moves, it displays fine, looks legal to me, etc.), and I retyped the moves many times, tryed to mess with the move number, to no avail. The first move in itself (11. Rc3) is not accepted, and actually ruins the display of the position.

(Or is it just me ?)

Answer 3

I noticed one more feature that has been missed out from your list but I have no idea how to annotate it, so will appreciate it if someone can fill the blanks in.

How can you specify which position is the current relevant one that you want the starting from. e.g. If I have imported a PGN (to include the entire game as reference) but I'm only interested in replaying the last 5 full moves, how can you jump to e.g. move 55/60 upon loading?

Answer 4

What am I doing wrong?
Why is this: Why is pawn to d3 the best move here? pair of replayers ignoring the FEN header? (Mine is the comment comparing ... Kg7 to ... f5).