# Manual de administração do &gcompris;

## Manual de administração

### Introdução

&gcompris; é um conjunto de softwares educacionais livres que contém uma grande quantidade e diversidade de atividades.

Ele oferece várias atividades voltadas para os mais diversos campos. Os tópicos abordados incluem leitura e digitação, aritmética, geografia, ciências, entre outros. E pode ser usado tanto em casa quanto nas escolas.

O objetivo do &gcompris; é oferecer um conjunto de atividades divertidas, mas sempre com um cunho educacional.

O &gcompris; é parte dos projetos da comunidade &kde; e é mantido sob a licença AGPLv3. Todo o código, com exceção do mecanismo da atividade de eletricidade analógica,está sob a Licença GPLv3.

&gcompris; is available on the following operating systems: &GNU;/&Linux;, &BSD;, MacOSX, &Windows;, Android. It requires a 3D card with support of OpenGL 2.1 or higher. 32 bits color depth mandatory.

### Instalação

O software está disponível de diversas formas. Escolha aquela que for mais adequada para você.

- &GNU;/&Linux;: use the packages delivered by your &GNU;/&Linux; distribution. If &gcompris; is not packaged in your &Linux; distribution, please contact them to ask for the inclusion of &gcompris; in your &Linux; distribution.

- &Windows;: disponibilizado através de um instalador clássico para &Windows; ou através da Microsoft Store.

- MacOSX: delivered under a classic installer.

- Android: distributed by the F-Droid store or Google Play Store. Apk file is also available.

### Interface do usuário

O design da interface foi pensado para ser de uso fácil, mesmo para crianças mais novas. O &gcompris; é controlado principalmente com o mouse ou tela de toque, mas a navegação via teclado também está disponível na maioria das atividades.

#### Janela principal

When you start the program, &gcompris; shows a graphic interface which presents the list of activities with a control bar at the bottom.

Here's a screenshot of &gcompris; Main Window Janela principal do &gcompris;

Each icon represents an activity. Around each one, you can find small icons which give additional information about the activity. A simple click on the icon will lead you to an activity or a menu of activities. There are 8 sections (categories) of activities, which are placed on the top or on the left (only if your orientation is portrait). For example, there is section "Board games", which includes board games, like chess, tic tac toe or align four.

Algumas categorias possuem subcategorias, para melhor filtragem das atividades. Por exemplo, as atividades de matemática possuem três subcategorias: numeração, aritmética e medidas.

As estrelas indicam a faixa etária para a qual cada jogo foi pensado:

- 1, 2 or 3 yellow stars - for 2 to 6 years old.

- 1, 2 or 3 red stars - greater than 6 years old.

Na parte inferior da tela existe uma barra de controle para o &gcompris;. Os ícones que podem aparecer lá (eles são exibidos somente se eles estiverem disponíveis na atividade) são os seguintes:

- Home - Leaves the current activity, returns to the previous menu.

- "OK" - Validate, confirm your answer. Some activities do not detect automatically whether or not the child has completed the task. In this case, you have to click on this icon. You can also use the &Enter; key on your keyboard.

- Light - Display a hint for the activity. We can help the children on some activities to guide them to find the answers.

- Arrows - The present level is displayed. Click on one of the arrows to select another level. Generally, the activities offer several levels whose numbers depend on the activity. In &gcompris;, it is possible to go to the next level without having completed the current level.

- Lips - Ask &gcompris; to repeat the question.

- Question mark - Display the help dialog box. Sometimes, an activity can be too complex to be described easily in the description area. In this case, this function gives access to additional information.

- Tool box - Configuration menu. The configuration is saved in the user repository (folder) under the name `.config/gcompris/gcompris-qt.conf`. This is a text file which can be edited manually.

- List item - Display the activity settings menu. There are two possible tabs here. First one, "Dataset", allows to choose the levels of the activities depending on several objectives and the second one, "Options", allows to update the configuration of the activity if available.

- Capital "G" - Information box on &gcompris;, presents the main contributors and the version of the software.

- Power - Quit &gcompris;. You can also use the shortcut on your keyboard &Ctrl;Q

#### Modo Quiosque

Quando você usar o &gcompris; com crianças mais novas ou em um quiosque de uso não supervisionado, poderá desativar algumas opções:

- ``gcompris --enable-kioskmode`` : disable the Quit and Configuration buttons.

- ``gcompris --disable-kioskmode`` : enable the Quit and Configuration buttons.

- ``gcompris -f`` : run &gcompris; in fullscreen mode

- ``gcompris -C`` : disable the cursor (touch screen mode)

Essas opções podem ser combinadas.

#### Atalhos de teclado

Atalhos | Ação
&Esc; ou &Ctrl;W | Abandona a atividade ou caixa de diálogo atual e volta ao menu principal.
&Ctrl;Q | Sai do &gcompris; sem perguntar.
&Ctrl;F | Alterna o modo de tela cheia.
&Ctrl;M | Alterna a desativação do som.
&Ctrl;B | Display or Hide the control bar.

### Notas sobre a tradução

O &gcompris; é traduzido e está disponível para mais de 35 idiomas. Para verificar se o seu idioma está disponível, inicie o &gcompris; e selecione-o nas opções de configuração.

Atenção ao fato de que alguns idiomas necessita de fontes específicas para serem exibidos corretamente.

Caso o seu idioma não seja suportado, você pode contribuir com o nosso software, adicionando a tradução para seu idioma. Se tiver interesse, você pode entrar em contato com a equipe de tradução do projeto &kde; para o seu idioma. Você pode verificar o nível de tradução para o seu idioma no site de tradução do &kde;.

### Aprendizagem de idiomas

Você pode usar o &gcompris; em um idioma estrangeiro, que você esteja aprendendo. Para isso, é só selecionar esse idioma no menu de configurações. Não se esqueça de fazer o download dos módulos de áudio opcionais para esse idioma.

### Personalização de atividades

Você pode personalizar algumas atividades usando o botão de configuração existente nelas. Por exemplo, poderá definir o idioma em algumas atividades de texto (como no jogo 'Palavras cadentes') ou mostrar imagens de carros reais ao invés de retângulos preenchidos (Quebra-cabeça com peças deslizantes).

Para algums atividades, você pode escolher entre vários conjuntos de dados na configuração. Cada um tem um objetivo específico descrito.

Dataset of activity "Count the items" Dataset of activity "Count the items"

Você pode selecionar as opções para esta atividade.

Select mode of activity "Count the items" Select mode of activity "Count the items"

### Console Switches

Running &gcompris; from a command console with the --help option will display all the parameters it accepts:

-f, --fullscreen | Executa o &gcompris; em modo de tela cheia.
-w, --window | Executa o &gcompris; em modo de janela.
-s, --sound | Executa o &gcompris; com o som habilitado.
-m, --mute | Executa o &gcompris; sem som.
-c, --cursor | Executa o &gcompris; com o cursor padrão do sistema.
-C, --nocursor | Executa o &gcompris; sem cursor (modo de tela sensível ao toque).
-v, --version | Mostra a versão do &gcompris;.
-l, --list-activities | Mostra todas as atividades disponíveis na saída padrão.
--launch atividade | Specify the activity when starting GCompris.
--start-level nível | Specify the level on which to start the activity specified by --launch option when starting GCompris. Ignored if no --launch option, or if level specified is invalid.
--difficulty {valor|mín-máx} | For the session, force GCompris activities difficulty to be either at value or between min and max values. The values must be between 1 and 6, and if the format is min-max, the min value must be lower than the max value. If it is not the case GCompris will not start.
--export-activities-as-sql | Exporta as atividades no formato SQL.
--enable-kioskmode | Ativa o modo quiosque (oculta os botões Sair e Configurações).
--disable-kioskmode | Desativa o modo quiosque (padrão).
--renderer={renderizador} | Specify which graphical renderer to use. On all platforms, opengl and software are available. On Windows, you can use direct3d11 or direct3d12 (if it was compiled with Qt >=6.6). On MacOS, you can use metal.
--software-renderer | Use software renderer instead of openGL (should work with any graphical card). Deprecated, use --renderer=software instead.
--opengl-renderer | Use openGL renderer instead of software (faster and more graphical effects but can crash with some graphical cards). Deprecated, use --renderer=opengl instead.

#### Exemplo no &Windows;

Você pode adicionar estas opções nas opções de execução do programa, no ícone do desktop do Windows. Segue um exemplo para executar o &gcompris; no modo de quiosque em tela cheia, sem o botão de configuração e o cursor:

``"C:\Program Files\GCompris-Qt\bin\GCompris.exe" --enable-kioskmode -f -C``

#### Exemplo no &GNU;/&Linux;

Create an application launcher and configure the command line parameters. Here is an example that runs &gcompris; in kiosk mode in full screen, without Config button and cursor:

``gcompris-qt --enable-kioskmode -f -C``

## Créditos e licença

&gcompris;

Program copyright 2000-2025 Timothée Giet and others

Tradução de FELA ahlr_2000@yahoo.com, André Marcelo Alvarenga alvarenga@kde.org e Frederico Gonçalves Guimarãesfrederico@teia.bio.br

&underFDL; &underGPL;
&documentation.index;