GuiasFerramentas

Ficheiros PGN explicados para jogadores de xadrez

O PGN é o formato de texto simples com que todos os programas de xadrez concordam. Eis o que está dentro de um e como mover as suas partidas entre aplicações.

O que é o PGN

PGN quer dizer Portable Game Notation. É um formato de texto simples para registar partidas de xadrez, escrito nos anos 90, e todos os programas de xadrez continuam a saber lê-lo e escrevê-lo.

Um ficheiro PGN é apenas texto. Pode abri-lo num editor de texto e lê-lo sem software especial.

Isso importa mais do que parece. Como o formato é simples e suportado em toda a parte, as suas partidas e a sua análise não ficam presas na aplicação que por acaso usou.

Lichess Lichess Chess.com Chess.com ChessBase ChessBase Chess Prep Pro Chess Prep Pro Partidas suas Partidas suas PGN um formato exporta de importa para
Um formato ao centro e tudo o resto dos dois lados. É essa a razão toda por que vale a pena conhecer o PGN.

Tudo o que está à esquerda desse esquema sabe escrever PGN. Tudo o que está à direita sabe lê-lo. Não há conversor ao meio, porque não há nada para converter.

O que está lá dentro

Uma entrada PGN tem duas partes: um conjunto de etiquetas e depois as jogadas.

[Event "Casual game"] [Site "Dublin"] [Date "2026.03.14"] [White "Player A"] [Black "Player B"] [Result "1-0"] 1. e4 e5 2. Nc3 Nf6 3. f4 d5 4. fxe5 Nxe4 1-0 pares de etiquetas texto de jogadas quem, quando, resultado jogadas e resultado uma linha em branco
Todas as entradas PGN têm a mesma forma. Quando consegue ver as duas metades, o formato deixa de ser misterioso.

As linhas entre parênteses rectos são os pares de etiquetas. Sete são padrão: Event, Site, Date, Round, White, Black e Result. O ficheiro continua válido se faltarem outras, ou se forem acrescentadas mais.

Tudo o que vem depois da linha em branco é o texto de jogadas. As jogadas estão em notação algébrica padrão, numeradas, e o resultado vem no fim. 1-0 quer dizer que as brancas ganharam, 0-1 que ganharam as negras, 1/2-1/2 é empate e * quer dizer que a partida está inacabada ou que o ficheiro é um estudo e não uma partida.

Comentários e variações

Dois acrescentos transformam um registo de partida em algo por onde se pode estudar.

Os comentários vão entre chavetas. Os motores ignoram-nos e a maioria do software mostra-os:

3. f4 {O Gambito de Viena. As brancas oferecem um peão para abrir a coluna f.} exf4

As variações vão entre parênteses e guardam alternativas à jogada que acabou de ser feita:

3... d5 (3... exf4 4. e5 {a principal alternativa} 4... Qe7) 4. fxe5

As variações podem estar dentro de variações, e é assim que um repertório inteiro cabe num ficheiro. A linha principal corre pelo texto de jogadas e cada alternativa ramifica entre parênteses. Um PGN de repertório costuma ter mais texto dentro dos parênteses do que fora deles.

Também pode ver símbolos como !, ? ou !? e códigos numéricos como $1. São juízos sobre a jogada anterior e pode ignorá-los sem problema.

Exportar dos grandes sítios

Lichess. Para uma partida, abra-a e escolha PGN no menu de partilha. Para um estudo, use a opção de transferir, que exporta todos os capítulos num único ficheiro. Para todas as suas partidas, a página de exportação nas preferências do perfil produz um arquivo.

Chess.com. As partidas individuais têm uma opção de transferência nos controlos de partilha por baixo do tabuleiro. As exportações em massa estão na secção de partidas da sua conta e não ao lado de uma partida.

ChessBase. As bases de dados usam formatos próprios do ChessBase, por isso é preciso uma conversão explícita. Seleccione as partidas e exporte ou guarde como PGN em vez de copiar o ficheiro da base. Algumas anotações específicas do ChessBase podem não sobreviver à viagem.

O seu próprio tabuleiro. A maioria dos tabuleiros de análise, incluindo os que estão dentro de aplicações de treino, produz PGN para a linha que estiver carregada.

O que costuma correr mal

  • O ficheiro tem mais do que uma partida. Os ficheiros PGN podem conter milhares, separadas por linhas em branco. Se uma importação só mostrar a primeira, o software provavelmente espera uma partida por ficheiro, ou tem uma importação em massa à parte.
  • Codificação. Nomes de jogadores com acentos chegam estropiados se o ficheiro foi guardado na codificação errada. Guardar em UTF-8 resolve a maioria dos casos.
  • Quebras de linha. O PGN permite que as jogadas passem para a linha seguinte, e alguns editores “corrigem” isso de formas que estragam o ficheiro. Edite num editor de texto simples, nunca num processador de texto.
  • Ficheiros muito grandes. Uma exportação de base de dados com dezenas de milhares de partidas é PGN válido, mas a maioria das ferramentas de estudo não foi feita para carregar uma. Divida primeiro.

Porque vale a pena perceber o formato

Quando sabe o que é o PGN, deixa de pensar na sua análise como algo que vive dentro de uma conta. É um ficheiro de texto que lhe pertence. Pode guardá-lo, enviá-lo por e-mail e carregá-lo na ferramenta que usar para o ano.

Na prática, isso quer dizer que pode construir um repertório num sítio e treiná-lo noutro. Manter estudos no Lichess e praticá-los noutro lado. Construir linhas no telemóvel e analisá-las no computador.

É por causa dessa portabilidade que o Chess Prep Pro lê texto PGN, ficheiros PGN e estudos do Lichess, e volta a exportar tudo isso.

  • PGN
  • Lichess
  • Chess.com
  • ChessBase