Documentação · O arquivo
Importar partidas
De um ficheiro PGN, do texto colado ou dos sites online, também os estudos: como se reconhecem os duplicados e o que resta das suas anotações.
A janela Importar partidas abre-se com o botão da barra de ferramentas ou em Ficheiro › Importar partidas… (⇧⌘I), e abre no separador da última importação. Na ficha de um adversário, Descarregar as partidas do adversário… abre-a no site dele, com o nome já escrito e Tudo definido.
Em cima, os quatro separadores: Ficheiro PGN, Colar, chess.com e lichess.org. Por baixo, o painel do separador escolhido; no fundo, Importar para, Cancelar e o botão que importa. Importa-se o separador que se vê: os outros guardam o que têm lá dentro, para depois.
Ficheiro PGN
Um ficheiro .pgn arrasta-se para a zona tracejada (“Largue aqui um ficheiro PGN”), ou escolhe-se com Escolher um
ficheiro…; largado em qualquer ponto da janela, a partir de qualquer separador, leva a Ficheiro PGN. Escolhido
o ficheiro, aparece o seu cartão: o nome, quantas partidas contém, o tamanho, Descartar e Escolher outro
ficheiro…. O botão passa a Importar N partidas. O tamanho não é um problema: o ficheiro lê-se um bocado de
cada vez, mesmo com milhões de partidas.
Um ficheiro .pgn aberto com um duplo clique no Finder, arrastado para o ícone da app na Dock ou aberto com Abrir
com › Terza Torre abre esta janela com o ficheiro já pronto: não importa sozinho.
Um ficheiro exportado de um estudo online oferece Escolher para onde vai cada capítulo…, como os estudos mais abaixo.
Colar
Colar da área de transferência põe na caixa o texto PGN que copiou; um segundo colar acrescenta-o a seguir. Também se pode escrever ou colar diretamente na caixa. Por baixo, quantas partidas encontrou, e Limpar.
chess.com e lichess.org
Escreve-se o Nome da conta e escolhe-se Desde quando: Último ano, Últimos 3 anos, Últimos 5 anos ou Tudo. Por baixo do campo estão As suas contas:, as contas desse site escritas no perfil, e, com o Pro, Os seus adversários:, os das fichas dos adversários: um clique escreve o nome. Mas serve o nome de qualquer pessoa, um amigo, um treinador, um adversário: não são precisas palavras-passe, e o site só recebe o nome.
Se o perfil não tiver uma conta nesse site, por baixo de um nome novo aparece É a sua conta? com Adicionar ao meu perfil.
Descarregar e importar verifica primeiro a conta: um nome que não existe, ou um período sem partidas, é indicado por baixo do campo, e a janela fica aberta. Caso contrário, a janela fecha-se, e a transferência e a importação continuam em segundo plano, em Tarefas em segundo plano, no fundo da barra lateral: primeiro “A descarregar de …” com as partidas que chegaram, depois a importação. Parar vale para as duas. Se terminar a app durante a transferência, a app avisa que a transferência se perde e que ainda não há nada no arquivo.
- O chess.com dá as partidas mês a mês, e o período vai por meses inteiros: Último ano, a meio de outubro, começa em outubro do ano anterior. Se algum mês não chegar, o resumo diz quantos: descarregando de novo, as partidas que já tem não ficam duplicadas. O chess.com não tem estudos, e as suas coleções de partidas descarregam-se uma de cada vez como PGN no site, para depois importar como ficheiro.
- O lichess envia as partidas uma após outra, e a janela diz a que velocidade: cerca de 20 por segundo sem sessão iniciada, por isso um histórico longo demora alguns minutos; com sessão iniciada no lichess, cerca de 30 por segundo para as partidas dos outros e cerca de 60 para as suas.
Iniciar sessão no lichess é opcional, e só se oferece para uma conta sua: Iniciar sessão no lichess…, por baixo do nome, abre a página do lichess onde dá a autorização. Com a sessão iniciada, as suas partidas descarregam-se três vezes mais depressa e vê também os seus estudos privados; Terminar sessão desliga-a. O mesmo se faz em Definições › Perfil: consulte Perfil.
Os estudos do lichess
No separador lichess.org, em cima, escolhe-se entre Partidas e Estudos. Com Estudos, o campo aceita o nome de um jogador ou a ligação de um estudo.
- Procurar estudos encontra os estudos públicos desse jogador; de uma conta sua, com a sessão iniciada, também os privados. Assinalam-se os que se querem importar (Marcar todos, Desmarcar todos) e passa-se a Seguinte.
- A app lê os capítulos e mostra-os um a um, cada um com o destino: Estudo, Partida, Deixar de fora e, com o Pro, para os seus estudos que partem da posição inicial, Repertório com as brancas e estudo ou Repertório com as pretas e estudo. Um capítulo com os jogadores ou um resultado é proposto como partida; uma linha de abertura de um estudo seu, com o Pro, vai para o repertório da cor do lado de onde o vê; o resto, como estudo. Um capítulo para o repertório é guardado também como estudo: o repertório guarda só os lances, o estudo também os comentários e as variantes. Um capítulo que não se consegue ler, ou vazio, fica de fora.
- Importar põe-nos onde escolheu. Um capítulo que já tem, com o mesmo conteúdo, não fica duplicado.
Um estudo privado em que participa, por exemplo do seu treinador, não aparece na lista, porque é privado da conta dele: cole a ligação dele, com a sessão iniciada no lichess, e conseguirá importá-lo, a não ser que o dono tenha reservado a exportação só para si. Nesse caso, o lichess não o deixa descarregar, e a janela di-lo: terá de lho pedir.
Os estudos importados encontram-se em Estudos, na barra lateral: consulte Os estudos.
Importar para
O menu no fundo põe as partidas importadas também numa coleção, ou numa nova com Nova coleção…. Na coleção vão parar também as partidas duplicadas que o arquivo já tinha: assim está lá tudo o que importou, sem cópias repetidas no arquivo.
Durante a importação
O botão fecha a janela e a importação continua em segundo plano: em Tarefas em segundo plano, no fundo da barra lateral, estão o progresso e Parar. A lista atualiza-se no fim. As partidas são escritas em blocos de alguns milhares: se parar, ou fechar a app, as que já foram escritas ficam. Se terminar a app durante uma importação, a app pergunta primeiro.
Uma importação de cada vez: com uma já em curso, a janela di-lo por cima do botão, com a sua barra. Enquanto trabalha, o Mac não entra em repouso sozinho.
O resumo
No fim fica no ecrã até o fechar com OK: Importação concluída, Importação interrompida, ou Importação interrompida por um erro com o erro. As linhas, só as que têm um número:
- quantas partidas foram importadas;
- quantas já estavam no seu arquivo;
- a quantas foram acrescentadas as anotações na cópia que tinha, e quantas não foram importadas por serem diferentes das que tem (consulte os duplicados, mais abaixo);
- quantas não se conseguiam ler, e quantas não são de xadrez padrão;
- do chess.com, os meses não descarregados;
- dos estudos do lichess, os capítulos guardados como estudos, os que já tinha, os lances acrescentados a cada repertório e os capítulos deixados de fora.
Se tiver um repertório e entre as partidas novas houver partidas suas, o resumo diz também se alguma saiu dele, e Mostrar no repertório leva a ver onde.
As partidas acrescentadas estão em Última importação, na barra lateral: só as novas, não os duplicados.
Os duplicados
Duas partidas são a mesma quando têm iguais:
- os dois jogadores. Um jogador com o ID FIDE é o seu ID, e o nome não conta: dois ID diferentes são dois jogadores mesmo com o mesmo nome, e uma cópia com o ID e outra sem ele são dois jogadores. Sem ID, contam as palavras do nome, em qualquer ordem, sem olhar a maiúsculas, acentos e pontuação: “Carlsen,Magnus”, “Carlsen, Magnus”, “CARLSEN Magnus” e “Magnus Carlsen” são o mesmo nome, “Carlsen, M.” não, e também não a alcunha “magnus-carlsen”, que é outro jogador (consulte Os nomes dos jogadores);
- a data, incluindo as partes que faltam: “1999” e “20 de janeiro de 1999” são datas diferentes;
- o resultado;
- a posição inicial e os lances da linha principal.
Torneio, local, Elo e anotações não contam.
O duplicado não entra, e os dados do seu cabeçalho não são juntados aos que tem. As suas anotações — comentários, símbolos, variantes, tempos, avaliações — vão para a sua cópia só se a sua não tiver nenhumas; se ambas as tiverem e forem diferentes, a sua fica como está e o resumo conta-as.
Para os duplicados que já estão no arquivo há Remover duplicados: consulte Estado do arquivo.
O que muda ao entrar
- Variantes do xadrez. Uma partida de Chess960 ou de outra variante não entra. As partidas a partir de uma posição dada, sim.
- Online ou presencial. Decide-se partida a partida: é online a jogada na Internet segundo o local (por exemplo “INT”), ou exportada de um site online. O nome do torneio não conta. Se se enganar, botão direito → Marcar como online ou Marcar como presencial, e a exportação guarda a sua escolha.
- A abertura (código ECO, nome e variante) é sempre a app que a reconhece, pelos lances: a que está escrita no ficheiro não se usa.
- Os nomes de pessoa tomam a forma habitual: “ROSSI,Mario” passa a “Rossi, Mario”. Não as alcunhas nem os nomes com algarismos ou “_”, e não as partidas descarregadas dos sites.
- As etiquetas que a app não tem, e os valores fora das suas listas, perdem-se. Os marcadores como “?” passam a campos vazios.
Os ficheiros
Só PGN. O texto pode estar em UTF-8 ou, linha a linha, na codificação dos programas antigos do Windows: os ficheiros mistos servem. O que está entre uma partida e a seguinte, como os títulos nos ficheiros do TWIC, é ignorado.
Sem a janela
- Um ficheiro PGN arrastado do Finder para a janela principal importa-se logo: na coleção que está a ver, em
Favoritos com a estrela, caso contrário só no arquivo. Largado numa linha da barra lateral, Favoritos ou uma
coleção, vai para essa lista. Enquanto o ficheiro está por cima, um véu diz para onde vai. Não há limite de
partidas, e em Tarefas em segundo plano há Parar. Vários ficheiros ao mesmo tempo, um ficheiro que não é
.pgn, sem partidas ou ilegível, ou uma importação já em curso: não se importa nada, e um aviso diz porquê. - ⌘V na lista das partidas importa o PGN que está na área de transferência, até 100 partidas (consulte A janela principal). Para quantidades maiores, um ficheiro.