diff --git a/docs/community.md b/docs/community.md index 9b98c90c..aee46c82 100644 --- a/docs/community.md +++ b/docs/community.md @@ -95,7 +95,7 @@ You can view the list of translation coordinators on [this page](https://qualcod --- - *Community maintained* + *Community maintained (WIP)* Translator coordinator: Alberto Antonio Rebonatto Neto [:octicons-arrow-right-24: Download language file](https://github.com/ccbogel/QualCoder/raw/refs/heads/master/other_languages/pt.zip) diff --git a/docs/doc/en/3.2.-Files.md b/docs/doc/en/3.2.-Files.md index 65bda3e5..96fec72c 100644 --- a/docs/doc/en/3.2.-Files.md +++ b/docs/doc/en/3.2.-Files.md @@ -51,7 +51,7 @@ PDF files are not pseudonymised. "Mark speakers" creates codes for every speaker in an interview or group discussion, and assigns utterances automatically. You can reach it via the file context menu or the following toolbar button: -![grafik](/images/c742fad3-f34b-471d-8794-1919b7f5935d.png) +![image](/images/c742fad3-f34b-471d-8794-1919b7f5935d.png) [See this section](4.1.-Coding-Text#auto-speaker-codings) for more details. @@ -59,12 +59,14 @@ PDF files are not pseudonymised. Filename entries can be changed in the database. The file names of the original files will not be changed. A right-click context menu allows you to view, export, delete a current file. The trashcan button is an option to select multiple files for deletion. The question mark '?' opens this help page. Files can be viewed either by right-click menu on the file, or by clicking the magnifying glass icon. This is where transcripts for audio and video can be entered, when viewing an audio or video file. -![button](/images/f03c0a5d-29ea-40c7-a5a1-917aeb894f9b.png)Bulk rename of all file rows. You provide a prefix and then a numbered suffix is added. This applies to all visible rows in the table. You can pre-select visible rows by right click and 'show this value' for example on an attribute. +### Bulk rename of all file rows. +You provide a prefix and then a numbered suffix is added. This applies to all visible rows in the table. You can pre-select visible rows by right click and 'show this value' for example on an attribute. This button allows you to bulk rename files: +![button](/images/f03c0a5d-29ea-40c7-a5a1-917aeb894f9b.png) ## Attributes {#attributes} -Attributes are variables to describe the files. These can be added using the (x) button or through the Manage Attributes menu option. They can be character or numeric. The above image shows an added character attribute called _origin_ as well as one of several reference attribute columns _Ref-author_. +Attributes are variables to describe the files. These can be added using the (x) button or through the Manage Attributes menu option. They can be character or numeric. The above image shows an added character attribute called _origin_ as well as one of several reference attribute columns *Ref_author*. Attributes can be exported to an Excel file via a button: ![image](/images/ccf331d7-63b6-460b-96df-41edd7cfe63b.png) @@ -123,20 +125,20 @@ You can select text that is not underlined and copy/replace without problems. Yo ## Audio and Video files {#audio-and-video-files} -Video (mov, mp4, wmv, ogg) and audio files (wav, mp3, m4a) can be imported. Loading an audio or video file will also automatically create a blank text transcribed file. This file will have the same name as the audio or video file, but have a '.txt' suffix. Initially, this text transcription will be empty. You can transcribe the file yourself or get the file professionally transcribed and copy and paste the text into this file. +Video (mov, mp4, wmv, ogg) and audio files (wav, mp3, m4a) can be imported. Loading an audio or video file will also automatically create a blank text transcribed file. This file will have the same name as the audio or video file, but have a `.txt` extension. Initially, this text transcription will be empty. You can transcribe the file yourself or get the file professionally transcribed and copy and paste the text into this file. -You can open an audio or video file to view. For video, this opens two windows, one for viewing the video and one for the controls and a transcript, shown below. When an audio or video file is loaded into QualCoder a blank text transcription file is automatically created. The transcription file name defaults to videoname.txt. +You can open an audio or video file to view. For video, this opens two windows, one for viewing the video and one for the controls and a transcript, shown below. When an audio or video file is loaded into QualCoder a blank text transcription file is automatically created. The transcription file name defaults to `videoname.txt`. The transcribed text file is created and stored within the database, and can be exported to a text file. The file can be edited. !!! warning - Important note: The edits occur within the database. An original text file is NOT changed. Transcriptions cannot be linked as an external file. + **Important note**: The edits occur within the database. An original text file is **NOT** changed. Transcriptions cannot be linked as an external file. -If you have a .srt file (a transcript file that is read by VLC) you can place this alongside the video inside the project folder, in the video folder, shown in the image below. When the video is played, the translation wording will be shown as subtitles in the video. Also, if you open the .srt file in a text editor, copy and paste this into the associated video text file. Then this text will be shown as the transcription for the video. +If you have a `.srt` file (a transcript file that is read by VLC) you can place this alongside the video inside the project folder, in the video folder, shown in the image below. When the video is played, the translation wording will be shown as subtitles in the video. Also, if you open the `.srt` file in a text editor, copy and paste this into the associated video text file. Then this text will be shown as the transcription for the video. ![image](/images/221aac54-1907-41a7-95cc-26899250b13a.png) -If you have ffmpeg installed a waveform is shown. If the audio files has multiple audio tracks, only the first track is shown for the waveform. +If you have [ffmpeg](https://ffmpeg.org/) installed a waveform is shown. If the audio files has multiple audio tracks, only the first track is shown for the waveform. ### Transcribing audio and video {#transcribing-audio-and-video} @@ -164,27 +166,27 @@ Manually transcribing audio and video is helped with some keyboard shortcuts. Tr The key shortcuts are: -Ctrl R Rewind 5 seconds +Ctrl+R Rewind 5 seconds -Alt R Alt Minus (release 3.3+) Rewind 30 seconds +Alt+R/Alt+Minus (available in 3.3+) Rewind 30 seconds -Alt F Alt Plus (release 3.3+) Forward 30 seconds +Alt+F/Alt+Plus (available in 3.3+) Forward 30 seconds -Ctrl S or Ctrl P Stop/Start toggle audio/video. From stop to play will rewind 2 seconds. +Ctrl+S or Ctrl+P Stop/Start toggle audio/video. From stop to play will rewind 2 seconds. -Ctrl Shift > Increase play rate up to 2 times +Ctrl+Shift > Increase play rate up to 2 times -Ctrl Shift < Decrease play rate down to 0.1 +Ctrl+Shift < Decrease play rate down to 0.1 The above controls are also available from the toolbar icons. -Ctrl T Insert timestamp in this format: [hh.mm.ss] +Ctrl+T Insert timestamp in this format: [hh.mm.ss] -Ctrl + N Add a speaker name. This also pauses the audio/video. +Ctrl+N Add a speaker name. This also pauses the audio/video. -Ctrl D Delete one or more speaker names. +Ctrl+D Delete one or more speaker names. -Ctrl 1 to 8 Insert speaker name in this format: [name] +Ctrl+1 to 8 Insert speaker name in this format: [name] ### Transcriptions that have codes, annotations and / or case-assigned {#transcriptions-that-have-codes-annotations-and-or-case-assigned} @@ -193,8 +195,8 @@ Sections of the text file or audio/video transcribed file will have sections of You can select text that is not underlined and copy/replace without problems. You can click on a position (**without selecting text**) to then type, delete, or paste text. This can occur in underlined (coded, annotated, case-assigned) or not underlined (not coded/annotated/case-assigned) text locations. You will see the underlines shift as text is added or removed. -!!!! "There are some limitations" - There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over) if those sections have a combination of not underlined (not coded/annotated/case-assigned) and underlined (coded, annotated, case-assigned). The reason is that the positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window by pressing the Cancel button. +!!! warning "There are some limitations" + It is best to avoid selecting sections of text to delete (or to type or paste over) if those sections have a combination of not underlined (not coded/annotated/case-assigned) and underlined (coded, annotated, case-assigned). The reason is that the positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window by pressing the Cancel button. ## Example files {#example-files} diff --git a/docs/doc/en/4.1.-Coding-Text.md b/docs/doc/en/4.1.-Coding-Text.md index 93e74d74..6232d8d3 100644 --- a/docs/doc/en/4.1.-Coding-Text.md +++ b/docs/doc/en/4.1.-Coding-Text.md @@ -140,11 +140,11 @@ It is always best to save a copy of the project before editing the text, to avoi * A. Annotate selected text -* B. Bookmark the current location in the current text file. Shift B to go to bookmark. +* B. Bookmark the current location in the current text file. Shift+B to go to bookmark. * C. In text area. Create a category. -* Ctrl E to enter and exit Edit mode. +* Ctrl+E to enter and exit Edit mode. * H. Hide and show the top section of controls on the screen. This provides a bigger area to view the text and to code. @@ -160,19 +160,19 @@ It is always best to save a copy of the project before editing the text, to avoi * Q. Quick code with the most recent code. (Must have a text selection) -* R. Select Recent codes. (Must have a text selection) + -* Ctrl R. Reverse text direction. May be needed for Arabic or other Right to left languages. +* Ctrl+R. Reverse text direction. May be needed for Arabic or other Right to left languages. * S. Search text. -* R. Opens Recently used codes for marking text. +* R. Opens Recently used codes for marking text (must have text selected). * U. Unmark one or more codes at a clicked text position. (QC Release 3.4) * V. Code selected text with a new code made from the selected text. Also called *in vivo* coding. -* Ctrl Z. Restores the last coding that was unmarked. +* Ctrl+Z. Restores the last coding that was unmarked. ## Search text {#search-text} @@ -193,7 +193,7 @@ Underneath the codes tree are the buttons: forward, back and a grid icon button Select a code and then click on the forward and back arrows. These now traverse through the text document showing the selected coded text. All other coded text is hidden. To restore and show all the codes, click on the now coloured grid button. !!! note - In the 4.0 version, the entire text file is dispayed. In the previous versions e.g. 3.8.2 there was an option to load a text file in chunks of 50,000 characters. If you need to load text in chunks, then we recommend you use the previous [QualCoder version 3.8.2](https://github.com/ccbogel/QualCoder/releases/tag/3.8.2). However note that PDF text loading changed from 3.8.2 to 4.0 which may cause inaccuracy with coding segment positions when opening a newer project (e.g. 4.0) in the older release (3.8.2 or earlier). + In the 4.0 version, the entire text file is dispayed. In the previous versions e.g. 3.8.2 there was an option to load a text file in chunks of 50,000 characters. If you need to load text in chunks, then we recommend you use the previous [QualCoder version 3.8.2](https://github.com/ccbogel/QualCoder/releases/tag/3.8.2). However note that PDF text loading changed from 3.8.2 to 4.0 which may cause inaccuracy with coding segment positions when opening a newer project (e.g. 4.0+) in the older release (3.8.2 or earlier). ## Show only important coded text {#show-only-important-coded-text} @@ -205,7 +205,7 @@ Export in odt format - compatible with LibreOffice and Microsoft Word. Either ew ## Right-hand pane {#right-hand-pane} -The right-hand side of the coding text pane has another pane tucked away. To open click and drag from the right-hand side of the window, or press the button next to the Help button. This pane contains options useful when coding. One button is when clicking on a code, the code name, code rule (memo) and random coded text examples from the project are displayed. The other button displays the project memo. +The right-hand side of the coding text pane has another pane tucked away. To open click and drag from the right-hand side of the window, or press the button next to the Help button. This pane contains options useful when coding. One button shows, when clicking on a code, the code name, code rule (memo) and random coded text examples from the project are displayed. The other button displays the project memo. ![image](/images/a6977ba3-bdf2-43c8-9097-562a252af815.png) @@ -220,7 +220,7 @@ When entering the edit mode, the entire file is loaded for editing. Other functi You can select text that is not underlined and copy/replace without problems. You can click on a position (without selecting text) to then type, delete, or paste text. This can occur in underlined (coded, annotated, case-assigned) or not underlined (not coded/annotated/case-assigned) text locations. You will see the underlines shift as text is added or removed. -There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over). This is particularly an issue if any of those sections have been underlined (coded, annotated, case-assigned). It may also be an The reason is that positions of the underlying codes/annotations/case-assigned may not correctly match as intended. +There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over). This is particularly an issue if any of those sections have been underlined (coded, annotated, case-assigned). A possible reason is that positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window. Then **before anything else is done** press the undo button (Back arrow) next to the Edit text button. diff --git a/docs/doc/pt/2.4.-Working-in-a-Team.md b/docs/doc/pt/2.4.-Working-in-a-Team.md index b5a6e476..25fd2e2e 100644 --- a/docs/doc/pt/2.4.-Working-in-a-Team.md +++ b/docs/doc/pt/2.4.-Working-in-a-Team.md @@ -3,52 +3,53 @@ path: 2.4.-Working-in-a-Team --- # Trabalhando em Equipe -Existem várias estratégias para organizar trabalho colaborativo no mesmo projeto em QualCoder. Escolha o que melhor se adequa à sua abordagem metodológica e ambiente de trabalho específico. + +Existem várias estratégias para organizar o trabalho colaborativo no mesmo projeto no QualCoder. Escolha aquele que melhor se adequa à sua abordagem metodológica e ambiente de trabalho específico. ## 1) Edição sequencial do mesmo projeto {#1-sequential-editing-of-the-same-project} -Essa abordagem pode ser aplicada tanto na codificação indutiva quanto na dedutiva. Baseia-se no princípio de que todos os membros da equipe trabalham nos mesmos arquivos do projeto, embora não simultaneamente. +Esta abordagem pode ser aplicada tanto na codificação indutiva quanto na dedutiva. Baseia-se no princípio de que todos os membros da equipe trabalham nos mesmos arquivos do projeto, embora não simultaneamente. -** Coordenação da Sequência do Trabalho: ** +**Coordenando da Sequência do Trabalho:** -* Você pode fazer isso via e-mail para que cada pessoa, ao completar suas tarefas, envie a pasta de projeto zipped para o indivíduo subsequente na lista. +* Você pode fazer isso via e-mail para que cada pessoa, ao completar suas tarefas, envie a pasta de projeto "zipada" (isto é, em arquivo compactado `.zip`, `.rar`, `.tar`, `.tar.gz`,etc) para o próximo indivíduo na lista. * Você também pode trabalhar sequencialmente no mesmo computador, usando a mesma pasta de projeto. -* Se você coordenar o trabalho manualmente, usar um serviço de compartilhamento de nuvem como OneDrive ou Dropbox para transferir os arquivos também é uma opção. No entanto, é crítico que a) em nenhuma circunstância duas pessoas acessem o mesmo projeto simultaneamente, e b) o projeto deve ser totalmente sincronizado com o serviço de nuvem antes de passar o trabalho para o próximo indivíduo. A pessoa sucesso deve também garantir que tenha baixado a versão mais recente da nuvem antes de iniciar suas tarefas. Tenha cuidado: As versões do projeto que saem de sincronia podem corromper seus dados, e você então tem que reverter para uma cópia de backup. -* Por favor, não use a exportação do Projeto REFI-QDA como uma abordagem de rotina para colaboração quando todos os codificadores estão usando o QualCoder. Use uma das outras opções descritas aqui. Se você precisa abrir um projeto em software diferente (por exemplo, Taguette, NVivo, Atlas.ti, MAXQDA, Dedoose, Quirkos), só então você deve usar a exportação do Projeto REFI-QDA. Os recursos do projeto podem ser perdidos ao transferir um projeto entre software qualitativo usando a exportação do Projeto REFI-QDA. +* Se você coordenar o trabalho manualmente, o uso de um serviço de compartilhamento em nuvem como OneDrive ou Dropbox para transferir os arquivos também é uma opção. No entanto, é importante que a) em nenhuma circunstância duas pessoas acessem o mesmo projeto simultaneamente, e b) o projeto deve ser totalmente sincronizado com o serviço de nuvem antes de passar o trabalho para o próximo indivíduo. Essa pessoa deve também garantir que tenha baixado a versão mais recente da nuvem antes de iniciar suas tarefas. Tenha cuidado: As versões do projeto que saem de sincronia podem corromper seus dados, e você então tem que reverter para um _backup_. +* Por favor, não use a exportação do Projeto REFI-QDA como uma abordagem de rotina para colaboração quando todos os codificadores estão usando o QualCoder. Use uma das outras opções descritas aqui. Se você precisa abrir um projeto em software diferente (por exemplo, Taguette, NVivo, Atlas.ti, MAXQDA, Dedoose, Quirkos), só então você deve exportar o Projeto em REFI-QDA. Alguns recursos do projeto podem ser perdidos ao transferir um projeto entre `software` de análise qualitativa usando a exportação do Projeto REFI-QDA. -Lidar com os nomes do codificador cuidadosamente (ver abaixo). +Lide com os nomes dos codificadores com cuidado (ver abaixo). -## 2) Usando um Projeto Mestre: A Abordagem de 'Codificação Separada Depois Mesclagem' {#2-using-a-master-project-the-coding-separately-then-merging-approach} +## 2) Usando um Projeto Mestre: A Abordagem de 'Codificação Separada seguida de Mesclagem' {#2-using-a-master-project-the-coding-separately-then-merging-approach} -Essa estratégia permite que sua equipe trabalhe simultaneamente até certo ponto. É mais eficaz se você usar uma abordagem de codificação dedutiva, onde o sistema de código não muda muito durante a análise. Se você usá-lo com codificação indutiva, esteja preparado para passar algum tempo limpando e consolidando o sistema de código ao fundir o trabalho de diferentes membros da equipe. +Esta estratégia permite que sua equipe trabalhe simultaneamente até certo ponto. É mais eficaz se você usar uma abordagem de codificação dedutiva, em que o sistema de código não muda muito durante a análise. Se você usá-lo com uma codificação indutiva, esteja preparado para passar algum tempo limpando e consolidando o sistema de códigos ao fundir o trabalho de diferentes membros da equipe. Siga estes passos: -* Criar um projeto mestre com o sistema de código já definido (se aplicável). -* Idealmente, importar todos os documentos empíricos nesta fase. Evite vincular a arquivos externos, pois isso complica a distribuição do projeto. -* Feche sua pasta de projeto, incluindo todas as subpastas e arquivos, e envie para seus colaboradores (e-mail, transferência de arquivos ou USB-stick). -* Decida sobre uma estratégia para lidar com nomes de codificadores em sua equipe, como explicado nas notas abaixo. -* Agora, cada membro da equipe pode descompactar sua cópia local do projeto e trabalhar nele de forma independente, adicionando códigos, codificação, memorandos, etc. No entanto, não edite o texto importado dos próprios documentos empíricos, uma vez que isso pode causar problemas durante o processo de fusão mais tarde. -* Finalmente, reúna todas as cópias locais e misture-as sequencialmente em seu projeto mestre, usando o [processo descrito aqui](6.1.-Imports-and-Exports#merge-projects). +* Crie um projeto mestre com o sistema de código já definido (se aplicável). +* Idealmente, importe todos os documentos empíricos nesta fase. Evite vincular a arquivos externos, pois isso complica a distribuição do projeto. +* Feche sua pasta de projeto, incluindo todas as subpastas e arquivos, e envie para seus colaboradores (e-mail, transferência de arquivos ou _pendrive_). +* Escolga sobre uma estratégia para lidar com nomes dos codificadores em sua equipe, como explicado nas notas abaixo. +* Agora, cada membro da equipe pode descompactar sua cópia local do projeto e trabalhar nele de forma independente, adicionando códigos, codificações, memorandos, etc. No entanto, não edite o texto importado dos próprios documentos empíricos, uma vez que isso pode causar problemas durante o processo de mesclagem mais tarde. +* Finalmente, reúna todas as cópias locais e misture-as sequencialmente em seu projeto mestre, usando o [processo descrito aqui](6.1.-Imports-and-Exports#merge-qualcoder-projects). -## Considerações importantes sobre nomes de codificadores {#important-considerations-regarding-coder-names} +## Considerações importantes sobre os nomes dos codificadores {#important-considerations-regarding-coder-names} -* Na maioria dos casos, você deseja ter um nome único para cada codificador em sua equipe para que as contribuições individuais possam ser identificadas mesmo após a fusão do projeto. -* No Projeto > Configurações, clique no botão "Alterar" ao lado do nome do codificador para abrir uma janela onde você pode alterar sua própria identidade ou criar, renomear ou mesclar outros codificadores dentro do projeto atual. +* Na maioria dos casos, é preferível ter um nome único para cada codificador em sua equipe para que as contribuições individuais possam ser identificadas mesmo após a mesclagem do projeto. +* Em Projeto > Configurações, clique no botão "Alterar" ao lado do nome do codificador para abrir uma janela onde você pode alterar sua própria identidade,criar, renomear ou mesclar outros codificadores dentro do projeto atual. -![Janela do codificador](/images/380291b1-6e34-4bd3-8344-182af8448140.png) +![Janela de codificadores](/images/380291b1-6e34-4bd3-8344-182af8448140.png) -(Note que a codificação do alto-falante é usada internamente para marcar automaticamente enunciados do alto-falante em transcrições. Este nome não deve ser usado para outros fins.) +(Note que a "📌Codificação do Interlocutor" é usada internamente para marcar automaticamente enunciados dos interlocutores em transcrições. Este nome não deve ser usado para outros fins.) -* Tenha cuidado, especialmente com a função Mesclar, pois não há Desfazer. Se você cometer um erro enquanto estiver na tela de nomes do codificador, pressione o botão cancelar e as alterações serão revertidas. Depois de clicar em OK, as alterações são permanentes. No entanto, a função merge fará uma cópia do seu projeto antes da merge com um sufixo pre coder merge . -* Na mesma janela, você pode controlar a visibilidade de outros colaboradores. Desde a versão 3.8 do QualCoder, as contribuições de outros codificadores são sempre visíveis e editáveis por padrão, a menos que você escolha o contrário. Esconder outros colaboradores é especialmente útil para medir a confiabilidade intercodificador, o que requer que várias pessoas codificem o mesmo documento sem influenciar umas às outras. -* Esta janela também é acessível a partir da barra de ferramentas no texto de código, imagem de código e espaço de trabalho PDF código, embora com opções limitadas. +* Tenha cuidado, especialmente com a função Mesclar, pois não há como desfazê-la. Se você cometer um erro enquanto estiver na tela de nomes dos codificadores, pressione o botão cancelar e as alterações serão revertidas. Depois de clique em OK, as alterações são permanentes. No entanto, a função de Mesclage, fará uma cópia do seu projeto antes da messcla com um sufixo `pre_coder_merge`. +* Na mesma janela, você pode controlar a visibilidade de outros colaboradores. Desde a versão 3.8 do QualCoder, as contribuições de outros codificadores são sempre visíveis e editáveis por padrão, a menos que você escolha o contrário. Ocultar outros colaboradores é especialmente útil para medir a confiabilidade entre os codificadores, o que requer que várias pessoas codificem o mesmo documento sem influenciar umas às outras. +* Esta janela também é acessível a partir da barra de ferramentas em Codificar Texto, Codificar Imagem e no espaço Codificar PDF, embora com opções limitadas. !!! warning - Não mantenha a pasta do projeto em uma unidade de rede ou em uma localização na nuvem, e acesse essa localização enquanto executa o Qualcoder. Se a conexão do banco de dados for perdida, ele corromperia o banco de dados enquanto o QualCoder está realizando uma série de operações de banco de dados. + Não mantenha a pasta do projeto em um disco de rede ou em uma localização na nuvem, e acesse essa localização enquanto executa o Qualcoder. Se a conexão do banco de dados for perdida, o banco de dados será corrompido enquanto o QualCoder está realizando uma série de operações de leitura e escrita do banco de dados. ## Cópias de segurança {#backups} -Faça um backup da pasta do projeto antes de fazer quaisquer alterações substanciais, como uma reorganização substancial de códigos e categorias, projetos de fusão ou códigos de fusão. O QualCoder realiza backups por hora (mantendo até os cinco mais recentes, se os backups estiverem definidos nas configurações). Além disso, não armazenar arquivos extras ou saídas dentro da pasta do projeto. +Faça um _backup_ da pasta do projeto antes de fazer quaisquer alterações substanciais, como uma reorganização profunfa de códigos e categorias, mescla de projetos ou de códigos. O QualCoder realiza backups por hora (mantendo até os cinco mais recentes se os _backups_ estiverem definidos nas configurações). Além disso, não armazene arquivos extras ou saídas dentro da pasta do projeto. -Além disso, para boas práticas de gerenciamento de dados, você deve ter um cronograma de backup regular para seu trabalho e também fazer backup do projeto para diferentes dispositivos ou unidades. \ No newline at end of file +Além disso, para boas práticas de gerenciamento de dados, você deve ter uma rotina regular de _backups_ para seu trabalho e também fazer o _backup_ do projeto para diferentes dispositivos ou discos. \ No newline at end of file diff --git a/docs/doc/pt/3.1.-Creating-a-New-Project.md b/docs/doc/pt/3.1.-Creating-a-New-Project.md index 8f36b123..810fe82d 100644 --- a/docs/doc/pt/3.1.-Creating-a-New-Project.md +++ b/docs/doc/pt/3.1.-Creating-a-New-Project.md @@ -6,28 +6,28 @@ path: 3.1.-Creating-a-New-Project Você pode **criar um novo projeto no menu ‘Projeto’.** -Se você nomeá-lo "Teste", o projeto será salvo como Test.qda. Test.qda é na verdade uma pasta com subpastas contendo o banco de dados, documentos empíricos e outros arquivos. Se você quiser enviar e-mail do projeto para outra pessoa, feche a pasta inteira. +Se você nomeá-lo "Teste", o projeto será salvo como Test.qda. Test.qda é na verdade uma pasta com subpastas contendo o banco de dados, documentos empíricos e outros arquivos. Se você quiser enviar o projeto por e-mail para outra pessoa, compacte a pasta inteira. ## Tela principal {#main-screen} -A aba Action Log na janela principal exibe várias alterações que são feitas ao usar o QualCoder. A janela principal tem uma barra de menu no topo cheio de opções. Existem cinco abas para: action log , manage , reports , coding e AI chat . Mudar diretamente entre tabulações é geralmente OK. Mas se você estiver adicionando, renomeando, excluindo arquivos em Gerenciar arquivos ou alterando códigos ou categorias de código na área de codificação, é melhor atualizar cada guia selecionando a opção relevante na barra de menu no topo da tela. Por exemplo, alterar arquivos em Gerenciar arquivos, em seguida, fazer codificação ou relatórios - selecione uma opção no Menu para codificação ou relatório, em vez de clicar diretamente na guia para codificação ou relatórios. Isto acontece porque algumas alterações de gestão podem não se actualizar. +A aba Registro de Ações na janela principal exibe várias alterações que são feitas ao usar o QualCoder. A janela principal tem uma barra de menu no topo cheia de opções. Existem cinco abas para: Registro de Ações , Gerenciar , Relatórios, Codificação e Chat de IA . Mudar diretamente entre as abas é geralmente OK. Mas se você estiver adicionando, renomeando, excluindo arquivos em Gerenciar Arquivos ou alterando códigos ou categorias de código na área Codificação, é melhor atualizar cada guia selecionando a opção relevante na barra de menu no topo da tela. Por exemplo, alterar arquivos em Gerenciar arquivos, em seguida, fazer codificações ou relatórios - selecione uma opção no Menu para codificação ou relatório, em vez de clicar diretamente na guia para codificação ou relatórios. Isto acontece porque algumas alterações no gerenciamento do banco de dados podem não ter atualizado atualizar. ![imagem](/images/dcb4d4e7-a39b-424b-84c4-d2915098914f.png) -**Não execute seu projeto a partir de uma localização em nuvem** (OneDrive, Dropbox, etc.). As razões são: às vezes os arquivos não podem ser importados para o projeto. Aceder a um projeto armazenado na nuvem de diferentes computadores é especialmente perigoso, pois pode causar problemas de sincronização e até corromper o banco de dados. Ver [esta página para estratégias seguras para trabalhar em uma equipe e em vários computadores](2.4.-Working-in-a-Team). Da mesma forma, **Não execute seu projeto a partir de um pendrive USB (flash)**, como a corrupção do banco de dados pode ocorrer. +**Não execute seu projeto a partir de uma localização na nuvem** (OneDrive, Dropbox, etc.). As razões são: às vezes os arquivos não podem ser importados para o projeto. Acessar um projeto armazenado na nuvem de diferentes computadores é especialmente perigoso, pois pode causar problemas de sincronização e até corromper o banco de dados. Veja [esta página para estratégias seguras para trabalhar em equipe e em vários computadores](2.4.-Working-in-a-Team). Da mesma forma, **Não execute seu projeto a partir de um _pendrive_ USB (_flash_)**, pois o banco de dados pode ser corrompido. !!! tip "Boas práticas de gestão de dados" - Para qualquer projeto, mantenha boas práticas de gerenciamento de dados, como ter backups armazenados regularmente e, idealmente, backups armazenados em diferentes locais (por exemplo, nuvem, pastas de computador diferentes, discos rígidos, pendrives USB). + Para qualquer projeto, mantenha boas práticas de gerenciamento de dados, como ter _backups_ armazenados regularmente e, idealmente, armazenados em diferentes locais (por exemplo, nuvem, pastas de computador diferentes, discos rígidos, _pendrives_). ## Escreva um memorando de projeto {#write-a-project-memo} -Isto é **especialmente importante se você quiser usar os recursos baseados em IA** no QualCoder. O memorando do projeto é usado para fornecer algumas informações contextuais sobre o projeto atual e o tipo de documentos empíricos com os quais estamos lidando. Esta informação, que está incluída em cada consulta, ajuda a IA a produzir respostas muito mais direcionadas e úteis. Você pode acessar o Memo do Projeto > Memo do Projeto. +Isto é **especialmente importante se você quiser usar os recursos baseados em IA** no QualCoder. O memorando do projeto é usado para fornecer algumas informações contextuais sobre o projeto atual e o tipo de documentos empíricos com os quais estamos lidando. Essa informação, a qual está incluída em cada _prompt_, ajuda a IA a produzir respostas muito mais direcionadas e úteis. Você pode acessar o Memorando do Projeto em Memorando > Memorando do Projeto. -![Imagem Exemplo do Projecto Memo](/images/c4c44cbe-9195-4cd3-a1f6-e9efccceb45d.png) +![Imagem Exemplo do Memorando do Projeto.](/images/c4c44cbe-9195-4cd3-a1f6-e9efccceb45d.png) -QualCoder fornece um modelo para as informações mais importantes. Você não precisa seguir esse modelo exatamente, mas tente ** manter a descrição do projeto curta** (entre 300 e 700 caracteres). Você também pode adicionar notas sobre seu referencial teórico, mas tenha cuidado para não "preformatar" a perspectiva da IA demais. +O QualCoder fornece um modelo para as informações mais importantes. Você não precisa seguir esse modelo exatamente, mas tente **manter a descrição do projeto curta** (entre 300 e 700 caracteres). Você também pode adicionar notas sobre seu referencial teórico, mas tenha cuidado para não "pré-formatar" demais a perspectiva da IA. -Se você também quiser usar o memorando do projeto para outras notas que não devem ser compartilhadas com a IA, você pode inserir a tag "######" no texto. Qualquer coisa abaixo desta marca não será enviada para a IA (isso funciona com qualquer memorando em QualCoder). +Se você também quiser usar o memorando do projeto para outras notas que não devem ser compartilhadas com a IA, você pode inserir a _tag_ "######" no texto. Qualquer coisa abaixo dessa marca não será enviada para a IA (isso funciona em qualquer memorando em QualCoder). -Se não quiser que o memorando do projecto seja enviado para a IA, desactiva- o na janela de Configuração. \ No newline at end of file +Se não quiser que o memorando do projeto seja enviado para a IA, desactive-o na janela de Configurações. \ No newline at end of file diff --git a/docs/doc/pt/3.2.-Files.md b/docs/doc/pt/3.2.-Files.md index 2f7bb358..3823d1ef 100644 --- a/docs/doc/pt/3.2.-Files.md +++ b/docs/doc/pt/3.2.-Files.md @@ -4,110 +4,115 @@ path: 3.2.-Files # Gerenciar arquivos -Cada arquivo é precedido por um ícone que descreve o tipo de arquivo. Outras colunas mostram o nome do arquivo, data de criação/carga, associação com casos e outros atributos. +Cada arquivo é precedido por um ícone que descreve o tipo de arquivo. Outras colunas mostram o nome do arquivo, data de criação/carregamento, associação com casos e outros atributos. -![imagem](/images/71172904-3ae5-4eb3-9b04-350f036f1c9d.png) +![image](/images/71172904-3ae5-4eb3-9b04-350f036f1c9d.png) ## Importando arquivos {#importing-files} -Importar texto de documentos de texto simples, docx, epub, md, odt, pdf, rtf e tex (LaTex.tex, note que os arquivos .input e ..include não são resolvidos). Importar imagens de: jpg, jpeg e png. Importar formatos de áudio/vídeo: mp3, m4a, mp4, wav, mov, ogg. PDFs podem ser codificados como texto ou imagens. Alternativamente, ao invés de importar arquivos para a pasta do projeto, você pode linkar para arquivos localmente no sistema de arquivos do seu computador. Esta pode ser uma boa opção se você tem uma estrutura de pastas específica que é importante para o seu projeto. +Importar texto de documentos de texto simples, docx, epub, md, odt, pdf, rtf e tex (LaTex.tex, note que os arquivos `|input` e `|include` não são resolvidos). Importar imagens em: jpg, jpeg e png. Importar formatos de áudio/vídeo: mp3, m4a, mp4, wav, mov, ogg. Os PDFs podem ser codificados como texto ou imagens. Alternativamente, ao invés de importar arquivos para a pasta do projeto, você pode criar vínculos (_links_) para arquivos locais no sistema de arquivos do seu computador. Esta pode ser uma boa opção se você tem uma estrutura de pastas específica que é importante para o seu projeto. Arquivos de texto contendo emoticons podem ser importados e exibidos. No entanto, os emoticons podem 'offset' faixas de codificação subsequentes, por 1 caractere por emoticon. -Importar e ligar botões: ![Importar e ligar botões](/images/dc98a9ef-0d0c-4365-b444-9b2c3f145cab.png) + + +Botões importar e vincular : ![Botões importar e vincular](/images/dc98a9ef-0d0c-4365-b444-9b2c3f145cab.png) Arquivos vinculados podem ser importados para a pasta do projeto e, inversamente, arquivos armazenados na pasta do projeto podem ser exportados para fora da pasta do projeto e vinculados. -Importar ligado, exportar para botões ligados: ![Importar o ficheiro ligado, exportar para os botões do ficheiro ligado](/images/81951366-1a88-4069-b82d-8d959cf2aaf4.png) +Botões importar vinculado, exportar para vinculado: ![Botões importar vinculado, exportar para vinculado](/images/81951366-1a88-4069-b82d-8d959cf2aaf4.png) -Você pode adicionar atributos de arquivo clicando no `(x)` Botão. Por exemplo, crie uma variável de caracteres chamada `location` E enchê-lo de nomes de cidades. +Você pode adicionar atributos de arquivo clicando no botão `(x)`. Por exemplo, crie uma variável de caracteres chamada `localização` e a preencha de nomes de cidades. -Se você está começando com QualCoder, abra o `Examples` pasta e importação `ID1.docx`, `ID2.odt`, e `seascape.jpg`. +Se você está começando com QualCoder, abra a pasta `Examples` e importe `ID1.docx`, `ID2.odt`, e `seascape.jpg`. -Após a importação, abra cada arquivo clicando duas vezes ou usando o menu com o botão direito do mouse. Você pode testar o pseudônimo (ver abaixo) removendo `ID2.odt`, adicionar `Joe Bloggs` através do botão Pseudonymise, e depois importando o arquivo novamente. +Após a importação, abra cada arquivo clicando duas vezes ou usando o menu com o botão direito do _mouse_. Você pode testar o a pseudonimização (ver abaixo) removendo `ID2.odt`, adicionar `Joe Bloggs` através do botão Pseudonimizar, e depois importe o arquivo novamente. ### PDFs {#pdfs} -PDFs com destaques podem ser importados e seus segmentos destacados codificados automaticamente. -Projetos antigos extraíram texto de forma diferente da versão 4.0. Assim, ao abrir um projeto mais antigo, a versão 4.0 tentará combinar os segmentos de texto o melhor possível. No entanto, pode não ser idêntico. +PDFs com destaques podem ser importados e seus segmentos destacados podem ser codificados automaticamente. +Projetos antigos extraíam texto de forma diferente da versão 4.0. Assim, ao abrir um projeto mais antigo, a versão 4.0 tentará combinar os trechos o melhor possível. No entanto, pode não ser idêntico. ### Pseudonimização (desidentificação dos dados) {#pseudonymisation-data-de-identification} -A pseudonimização está disponível para substituir palavras ou frases. Para muitas línguas (possivelmente, exceto chinês, japonês, coreano), fornecendo o personagem antes da frase e o personagem após a frase são não-alfabeticos e não-numéricos, este é um ponto de corte fácil de aprovar. A pseudonimização é sensível a casos. As palavras originais devem ter pelo menos 2 caracteres, e os pseudônimos devem ter pelo menos 3 caracteres. Alternativamente, deixe o pseudônimo em branco para um termo gerado aleatoriamente. +A pseudonimização está disponível para substituir palavras ou frases. Para muitas línguas (possivelmente, exceto chinês, japonês, coreano), assumindo que o caracter antes da frase e o caracter após a frase não sejam alfabeticos e numéricos,este é um critério de corte fácil de aplicar. A pseudonimização é sensível à capitulação do texto. As palavras originais devem ter pelo menos 2 caracteres, e os pseudônimos devem ter pelo menos 3 caracteres. Alternativamente, deixe o pseudônimo em branco para um termo gerado aleatoriamente. -Um botão 'Anonymise na importação' é acessado em Gerenciar arquivos. Isso permite que você configure uma lista de termos originais para pseudônimos, e deve estar em vigor antes de qualquer documento de texto de importação. Não se aplica retroactivamente a documentos já importados. +Um botão 'Anonimizar na importação' pode ser acessado em Gerenciar arquivos. Isso permite que você configure uma lista de termos originais para pseudônimos, e deve estar configurada antes de qualquer documento de texto ser importado. Não se aplicar isso retroativamente a documentos já importados. -![imagem](/images/c595539d-e1cb-41d5-a78c-7e987f9d5490.png) -O botão abre uma janela para permitir que o usuário adicione, ou remova da lista, as palavras ou frases a serem anonimizadas. Além disso, para que cada nova frase seja pseudononimizada, verifique se o termo de substituição ainda não foi utilizado na lista anonimizada. +![image](/images/c595539d-e1cb-41d5-a78c-7e987f9d5490.png) +Esse botão abre uma janela para permitir que o usuário adicione, ou remova da lista, as palavras ou frases a serem anonimizadas. Além disso, para que cada nova frase seja pseudononimizada, verifique se o termo de substituição ainda não foi utilizado na lista anonimizada. -A lista que você cria é armazenada na pasta do projeto, a pasta qda. A lista é armazenada no formato json. Após toda importação ser feita, o pesquisador pode remover o arquivo para um local seguro diferente, para referência conforme necessário. O arquivo json pode ser aberto em um editor de texto como NotePad. +A lista que você cria é armazenada na pasta do projeto, a pasta `.qda`. A lista é armazenada no formato `json`. Após toda importação ser feita, o pesquisador pode remover o arquivo para um local seguro diferente, para referência conforme necessário. O arquivo `json` pode ser aberto em um editor de texto como o Bloco de Notas. -Os ficheiros de texto e as colunas qualitativas importados serão pseudónimos. +Os arquivos de texto e as colunas qualitativas de _surveys_ importadas serão pseudnonimizados. -Os arquivos PDF não são pseudônimos. +Os arquivos PDF não são pseudnonimizados. -## Codificações de colunas automáticas {#auto-speaker-codings} +## Codificação automática de interlocutores {#auto-speaker-codings} -"Mark Speakers" cria códigos para cada palestrante em uma entrevista ou discussão em grupo, e atribui enunciados automaticamente. Você pode alcançá-lo através do menu de contexto do arquivo ou do seguinte botão da barra de ferramentas: +"Marcar interlocutores" cria códigos para cada interlocutor em uma entrevista ou discussão em grupo, e atribui enunciados automaticamente. Você pode acessar tal opção através do menu de contexto do arquivo ou do seguinte botão da barra de ferramentas: -![grafik](/images/c742fad3-f34b-471d-8794-1919b7f5935d.png) +![image](/images/c742fad3-f34b-471d-8794-1919b7f5935d.png) [Veja esta secção](4.1.-Coding-Text#auto-speaker-codings) para mais detalhes. ## Funções gerais {#general-functions} -Os itens de nome de arquivo podem ser alterados no banco de dados. Os nomes dos ficheiros originais não serão alterados. Um menu de contexto com o botão direito do mouse permite visualizar, exportar, excluir um arquivo atual. O botão lixo é uma opção para selecionar vários arquivos para exclusão. O ponto de interrogação '?' abre esta página de ajuda. Os arquivos podem ser vistos pelo menu com o botão direito do mouse no arquivo, ou clicando no ícone da lupa. É aqui que podem ser inseridas transcrições para áudio e vídeo, ao visualizar um arquivo de áudio ou vídeo. +Os itens de nome de arquivo podem ser alterados no banco de dados. Os nomes dos arquivos originais não serão alterados. Um menu de contexto com o botão direito do mouse permite visualizar, exportar, excluir um arquivo atual. O botão lixo é uma opção para selecionar vários arquivos para exclusão. O ponto de interrogação '?' abre esta página de ajuda. Os arquivos podem ser vistos pelo menu com o botão direito do mouse no arquivo, ou clicando no ícone da lupa. É aqui que podem ser inseridas transcrições para áudio e vídeo, ao visualizar um arquivo de áudio ou vídeo. + +### Renomear em massa todas as linhas de arquivos. -![botão](/images/f03c0a5d-29ea-40c7-a5a1-917aeb894f9b.png)Renomear em massa todas as linhas de arquivos. Você fornece um prefixo e então um sufixo numerado é adicionado. Isto aplica-se a todas as linhas visíveis na tabela. Você pode pré-selecionar linhas visíveis com o clique direito e 'mostrar este valor' por exemplo em um atributo. -Este botão permite- lhe alterar o nome dos ficheiros: +Você fornece um prefixo e então um sufixo numerado é adicionado. Isto aplica-se a todas as linhas visíveis na tabela. Você pode pré-selecionar linhas visíveis com o botão direito e 'mostrar este valor' em um atributo, por exemplo. +Este botão permite-lhe alterar o nome dos arquivos: +![button](/images/f03c0a5d-29ea-40c7-a5a1-917aeb894f9b.png) ## Atributos {#attributes} -Atributos são variáveis para descrever os arquivos. Estes podem ser adicionados usando o botão (x) ou através da opção de menu Gerenciar atributos. Eles podem ser caráter ou numérico. A imagem acima mostra um atributo de caracteres adicionado chamado origin , bem como uma das várias colunas de atributos de referência Ref-autor . +Atributos são variáveis para descrever os arquivos. Estes podem ser adicionados usando o botão (x) ou através da opção de menu Gerenciar atributos. Eles podem ser caracteres ou numéricos. A imagem acima mostra um atributo de caracteres adicionado chamado _origin_, bem como uma das várias colunas de atributos de referência *Ref_author*. -Atributos podem ser exportados para um arquivo Excel através de um botão: ![imagem](/images/ccf331d7-63b6-460b-96df-41edd7cfe63b.png) +Atributos podem ser exportados para um arquivo Excel através de um botão: ![image](/images/ccf331d7-63b6-460b-96df-41edd7cfe63b.png) ## Filtrar colunas e linhas {#filtering-columns-and-rows} ### Filtrar linhas {#filtering-rows} -O menu de contexto com o botão direito do mouse também permite que você reordene os arquivos de acordo com o nome, data e tipo de arquivo e quando clicar com o botão direito nas colunas nome ou data. Você pode mostrar apenas os tipos de atributos selecionados: Escolha Mostrar esta opção de valor +O menu de contexto com o botão direito do _mouse_ também permite que você reordene os arquivos de acordo com o nome, data e tipo de arquivo e quando clicar com o botão direito nas colunas nome ou data. Você pode mostrar apenas os tipos de atributos selecionados: Escolha Mostrar esta opção de valor Você também pode selecionar Mostrar valores como. Mostrar valores como pode ser aplicado várias vezes para encurtar ainda mais a lista de linhas exibidas. ### Visibilidade da coluna {#column-visibility} -Às vezes, muitas colunas podem ser exibidas, o que pode ser esmagador. Você pode ocultar colunas clicando com o botão direito na linha de cabeçalho da tabela para opções para ocultar essa coluna ou para ocultar colunas começando com texto específico. Ou para mostrar colunas onde o nome da coluna começa com texto específico. +Às vezes, muitas colunas podem ser exibidas, o que pode ser difícil de trabalhar. Você pode ocultar colunas clicando com o botão direito na linha de cabeçalho da tabela em opções > ocultar esta coluna ou para ocultar colunas começando com um texto específico. Ou para mostrar colunas onde o nome da coluna começa com texto específico. -### Salvar e carregar os filtros coluna e linha {#save-and-load-column-and-row-filters} +### Salvar e carregar os filtros de coluna e linha {#save-and-load-column-and-row-filters} -Existem três botões para salvar, carregar e excluir as configurações do filtro, para que você possa visualizar a tabela gerenciar arquivos de maneiras que você deseja, rapidamente. +Existem três botões para salvar, carregar e excluir as configurações do filtro, para que você possa rapidamente visualizar a tabela de gerenciamento de arquivos do modo que você desejar. ![Botões para salvar, carregar e excluir filtros de tabela](/images/96ae69f5-1493-4aa8-a3f5-31ee15c22fef.png) ## Abrir URLs de atributos {#open-attribute-urls} -Clique com o botão direito em um URL em um atributo e abra o URL com o navegador padrão. Isto é somente se o atributo for um URL e passar a validação de URL. +Clique com o botão direito em uma URL em um atributo e abra a URL com o navegador padrão. Isto ocorre somente se o atributo for uma URL e passar a validação de URL. ## Copiar referência para a área de transferência {#copy-reference-to-clipboard} -Use a opção de menu do botão direito para colunas de referência (Ref Autors, Ref Título, Ref Journal, Ref Type, Ref Ano). Isso permite copiar referência à área de transferência como uma referência de estilo Vancouver ou APA. +Use a opção de menu do botão direito para colunas de referência (Ref_Authors, Ref_Title, Ref_Journal, Ref_Type, Ref_Year). Isso permite copiar referência à área de transferência como uma referência em estilo Vancouver ou APA. -## Atribuir um ficheiro seleccionado a um caso {#assign-a-selected-file-to-a-case} +## Atribuir um arquivo seleccionado a um caso {#assign-a-selected-file-to-a-case} Você pode atribuir um arquivo a um caso através do menu com o botão direito do mouse quando na coluna de casos. ## Inteligência Artificial {#artificial-intelligence} -Se você ativou a integração de IA no QualCoder, os arquivos de texto recém-importados serão lidos pelo modelo de IA local e armazenados em sua memória local. Isso acontece em segundo plano (a barra de status mostra "AI: leitura"). Você pode continuar usando o QualCoder, mas os recursos aprimorados por IA não estarão disponíveis até que o IA tenha terminado de atualizar sua memória. Isso também acontece se você editar um arquivo de texto já importado no QualCoder. +Se você ativou a integração de IA no QualCoder, os arquivos de texto recém-importados serão lidos pelo modelo de IA local e armazenados em sua memória local. Isso acontece em segundo plano (a barra de status mostra "IA: lendo"). Você pode continuar usando o QualCoder, mas os recursos aprimorados por IA não estarão disponíveis até que a IA tenha terminado de atualizar sua memória. Isso também acontece se você editar um arquivo de texto já importado no QualCoder. -Se você tiver a impressão de que a memória IA está fora de sincronia e perdeu algumas atualizações de seus dados (o que não deve acontecer em circunstâncias normais), você pode reconstruir a memória do zero selecionando "AI > Reconstruir Memória Interna". Isto irá reler todos os documentos, o que pode levar algum tempo. +Se você tiver a impressão de que a memória IA está dessincronizada e perdeu algumas atualizações de seus dados (o que não deve acontecer em circunstâncias normais), você pode reconstruir a memória do zero selecionando "IA > Reconstruir Memória Interna". Isto irá reler todos os documentos, o que pode levar algum tempo. ## Criação e edição de arquivos de texto {#text-file-creation-and-editing} -Você pode criar e inserir texto em texto no banco de dados pressionando o ícone lápis. +Você pode criar e inserir texto em texto no banco de dados pressionando o ícone de lápis. -Botão Criar entrada de texto: ![Botão do ícone do lápis, para criar um arquivo de texto simples](/images/3e25677d-56de-48b5-81e3-e292979672be.png) +Botão Criar entrada de texto: ![Botão com ícone de lápis, para criar um arquivo de texto simples](/images/3e25677d-56de-48b5-81e3-e292979672be.png) Arquivos de texto podem ser editados, desde que não tenha sido realizada nenhuma codificação ou anotações ou atribuição de caso com o arquivo de texto. @@ -116,94 +121,94 @@ Arquivos de texto podem ser editados, desde que não tenha sido realizada nenhum Seções do arquivo de texto ou arquivo áudio/vídeo transcrito terão seções de texto sublinhadas em verde (caso atribuído), amarelo (anotação) ou vermelho (codificado). O texto pode ser editado mesmo após o texto ser codificado ou anotado ou atribuído (total ou parcialmente) a um caso. -Você pode selecionar texto que não está sublinhado e copiar/substituir sem problemas. Você pode clicar em uma posição (**sem selecionar uma seção de texto**) para então digitar, excluir ou colar texto. Isto pode ocorrer em locais de texto sublinhados (codificados, anotados, atribuídos a casos) ou não sublinhados (não codificados/anotados/atribuídos a casos). Você verá o deslocamento de sublinhados como texto é adicionado ou removido. +Você pode selecionar texto que não está sublinhado e copiar/substituir sem problemas. Você pode clicar em uma posição (**sem selecionar um trecho do texto**) para então digitar, excluir ou colar texto. Isto pode ocorrer em locais de texto sublinhados (codificados, anotados, atribuídos a casos) ou não sublinhados (não codificados/anotados/atribuídos a casos). Você verá o deslocamento de sublinhados conforme se adicionao ou remove. !!! info Existem algumas limitações: É melhor evitar selecionar seções de texto para excluir (ou digitar ou colar) se essas seções tiverem uma combinação de não sublinhado (não codificado/anotado/atribuído caso) e sublinhado (codificado, anotado, atribuído caso). A razão é que as posições dos códigos/anotações subjacentes/caixa atribuída podem não corresponder correctamente ao previsto. Se você fez uma alteração que você acha que afetou estas posições codificadas/anotadas/atribuídas mal, saia da janela de edição de texto pressionando o botão Cancelar. ## Arquivos de áudio e vídeo {#audio-and-video-files} -Video (mov, mp4, wmv, ogg) e arquivos de áudio (wav, mp3, m4a) podem ser importados. Carregar um arquivo de áudio ou vídeo também criará automaticamente um arquivo transcrito de texto em branco. Este arquivo terá o mesmo nome que o arquivo de áudio ou vídeo, mas tem um sufixo '.txt'. Inicialmente, esta transcrição de texto estará vazia. Você pode transcrever o arquivo você mesmo ou obter o arquivo transcrito profissionalmente e copiar e colar o texto neste arquivo. +Video (mov, mp4, wmv, ogg) e arquivos de áudio (wav, mp3, m4a) podem ser importados. Carregar um arquivo de áudio ou vídeo também criará automaticamente um arquivo transcrito de texto em branco. Este arquivo terá o mesmo nome que o arquivo de áudio ou vídeo, mas tem extensão `.txt`. Inicialmente, esta transcrição de texto estará vazia. Você pode transcrever o arquivo você mesmo ou obter o arquivo transcrito profissionalmente e copiar e colar o texto neste arquivo. -Você pode abrir um arquivo de áudio ou vídeo para visualizar. Para o vídeo, isso abre duas janelas, uma para visualização do vídeo e outra para os controles e uma transcrição, mostrada abaixo. Quando um arquivo de áudio ou vídeo é carregado no QualCoder, um arquivo de transcrição de texto em branco é automaticamente criado. O nome do arquivo de transcrição é padrão para videoname.txt. +Você pode abrir um arquivo de áudio ou vídeo para visualizá-lo. Para o vídeo, isso abre duas janelas, uma para visualização do vídeo e outra para os controles e uma transcrição, mostrada abaixo. Quando um arquivo de áudio ou vídeo é carregado no QualCoder, um arquivo de transcrição de texto em branco é automaticamente criado. O nome do arquivo de transcrição é padrão para `nomedovideo.txt`. O arquivo de texto transcrito é criado e armazenado dentro do banco de dados, e pode ser exportado para um arquivo de texto. O arquivo pode ser editado. !!! warning - Nota importante: As edições ocorrem dentro do banco de dados. Um arquivo de texto original NÃO é alterado. As transcrições não podem ser ligadas como um ficheiro externo. + **Importante**: As edições ocorrem dentro do banco de dados. Um arquivo de texto original **NÃO** é alterado. As transcrições não podem ser vinculadas como um arquivo externo. -Se você tem um arquivo .srt (um arquivo de transcrição que é lido por VLC) você pode colocar isso ao lado do vídeo dentro da pasta do projeto, na pasta de vídeo, mostrado na imagem abaixo. Quando o vídeo é reproduzido, o texto da tradução será mostrado como legendas no vídeo. Além disso, se você abrir o arquivo .srt em um editor de texto, copie e cole isso no arquivo de texto de vídeo associado. Em seguida, este texto será mostrado como a transcrição para o vídeo. +Se você tem um arquivo `.srt` (um arquivo de transcrição que é lido pelo VLC) você pode colocá-lo ao lado do vídeo dentro da pasta do projeto, na pasta de vídeo, mostrado na imagem abaixo. Quando o vídeo é reproduzido, o texto da tradução será mostrado como legendas no vídeo. Além disso, se você abrir o arquivo `.srt` em um editor de texto, copie e cole isso no arquivo de texto do vídeo associado. Em seguida, este texto será mostrado como a transcrição para o vídeo. -![imagem](/images/221aac54-1907-41a7-95cc-26899250b13a.png) +![image](/images/221aac54-1907-41a7-95cc-26899250b13a.png) -Se tiver o ffmpeg instalado, é mostrada uma forma de onda. Se os arquivos de áudio tem várias faixas de áudio, apenas a primeira faixa é mostrada para o waveform. +Se tiver o [ffmpeg](https://ffmpeg.org/) instalado, é mostrada uma forma de onda. Se os arquivos de áudio tem várias faixas de áudio, apenas a primeira faixa é mostrada em _waveform_. ### Transcrição de áudio e vídeo {#transcribing-audio-and-video} -Para transcrever, abra a opção do menu Gerenciar arquivos e, em seguida, veja o arquivo de áudio ou vídeo. O áudio/vídeo irá carregar e haverá uma área de texto para inserir texto transcrito. +Para transcrever, abra a opção do menu Gerenciar arquivos e, em seguida, veja o arquivo de áudio ou vídeo. O áudio/vídeo irá carregar e haverá uma área de texto para inserir o texto da transcrição. -O QualCoder não tem um recurso automatizado de áudio para texto. Use outros serviços como: Microsoft Word Transcribe, [lontra.ai](https://otter.ai/), [Vosk](https://alphacephei.com/vosk/install), [audapolis](https://github.com/audapolis/audapolis), [noScribe](https://github.com/kaixxx/noScribe) um transcriber offline para 99 idiomas diferentes ou [SocioTranscribe](https://framagit.org/justinmponcet/whisper). +O QualCoder não tem um recurso automatizado de transcrição de áudio. Use outros serviços como: Microsoft Word Transcribe, [otter.ai](https://otter.ai/), [Vosk](https://alphacephei.com/vosk/install), [audapolis](https://github.com/audapolis/audapolis), [noScribe](https://github.com/kaixxx/noScribe) (um transcritor offline para 99 idiomas diferentes) ou [SocioTranscribe](https://framagit.org/justinmponcet/whisper). -As transcrições podem conter datas indicando quando o texto está sendo pronunciado durante o vídeo. Os seguintes formatos são reconhecidos pela QualCoder, onde SSS são milissegundos: +As transcrições podem conter marcações de tempo (_timestamps_) indicando quando o texto está sendo pronunciado durante o vídeo. Os seguintes formatos são reconhecidos pelo QualCoder, onde SSS são milissegundos: -``` +```text [hh:mm:ss] , [mm:ss] , [hh.mm.ss] , [mm.ss] ``` -Para o acima, os parênteses podem ser [] ou {}. Estes podem ser alterados no menu Configurações. +Para os exemplos acima, os delimeitadores podem ser [] ou {}. Estes podem ser alterados no menu Configurações. -``` +```text #hh:mm:ss.SSS# , hh:mm:ss,SSS --> hh:mm:ss,SSS ``` O arquivo de vídeo pode conter várias faixas de áudio. Existe uma caixa suspensa que lhe permite escolher outra faixa de áudio. -As transcrições podem conter nomes de alto-falantes indicando quem está falando. Os nomes dos oradores estão emparelhados neste formato: [nome] ou {nome} ou nome: . +As transcrições podem conter nomes de interlocutores, indicando quem está falando. Os nomes dos interlocutores podem estar neste formato: [nome] ou {nome} ou nome: . -A transcrição manual de áudio e vídeo é ajudada com alguns atalhos de teclado. A transcrição e adição ou edição de texto só pode ocorrer se o texto existente não tiver códigos ou anotações. +A transcrição manual de áudio e vídeo pode ser mais rápida com alguns atalhos de teclado. A transcrição e adição ou edição de texto só pode ocorrer se o texto existente não tiver códigos ou anotações. Os atalhos de teclas são: -Ctrl R Rebobinar 5 segundos +Ctrl+R Rebobinar 5 segundos -Alt R Alt Minus (lançamento 3.3+) Rebobina 30 segundos +Alt+R/Alt+Minus (introduzido na 3.3) Rebobina 30 segundos -Alt F Alt Plus (lançamento 3.3+) Avançar 30 segundos +Alt+F/Alt+Plus (introduzido na 3.3) Avançar 30 segundos -Ctrl S ou Ctrl P Parar/Iniciar alternar áudio/vídeo. De parada para jogar vai voltar 2 segundos. +Ctrl+S ou Ctrl+P Parar/Iniciar áudio/vídeo. Ao parar e (re)iniciar, a mídia vai rebobinar 2 segundos. -Ctrl Shift > Aumentar a taxa de jogo até 2 vezes +Ctrl+Shift > Aumentar a taxa de jogo até 2 vezes -Ctrl Shift < Diminuir a taxa de reprodução para 0. 1 +Ctrl+Shift < Diminuir a taxa de reprodução para 0. 1 Os controles acima também estão disponíveis nos ícones da barra de ferramentas. -Ctrl T Inserir a hora neste formato: [hh.mm.ss] +Ctrl+T Inserir a hora neste formato: [hh.mm.ss] -Ctrl + N Adicionar um nome de alto-falante. Isso também pausa o áudio/vídeo. +Ctrl+N Adicionar um nome de interlocutor. Isso também pausa o áudio/vídeo. -Ctrl D Apagar um ou mais nomes de colunas. +Ctrl+D Apagar um ou mais nomes de interlocutor. -Ctrl 1 a 8 Inserir nome de coluna neste formato: [nome] +Ctrl+1 a 8 Inserir nome de interlocutor neste formato: [nome] -### Transcrições que têm códigos, anotações e / ou casos atribuídos {#transcriptions-that-have-codes-annotations-and-or-case-assigned} +### Transcrições que têm códigos, anotações e/ou casos atribuídos {#transcriptions-that-have-codes-annotations-and-or-case-assigned} -Seções do arquivo de texto ou arquivo áudio/vídeo transcrito terão seções de texto sublinhadas em verde (caso atribuído), amarelo (anotação) ou vermelho (codificado). O texto pode ser editado mesmo após o texto ser codificado ou anotado ou atribuído (total ou parcialmente) a um caso. +Trechos de arquivo de texto ou arquivo transcrito de áudio/vídeo terão seções de texto sublinhadas em verde (caso atribuído), amarelo (anotação) ou vermelho (codificado). O texto pode ser editado mesmo após o texto ser codificado ou anotado ou atribuído (total ou parcialmente) a um caso. -Você pode selecionar texto que não está sublinhado e copiar/substituir sem problemas. Você pode clicar em uma posição (**sem selecionar texto**) para então digitar, excluir ou colar texto. Isto pode ocorrer em locais de texto sublinhados (codificados, anotados, atribuídos a casos) ou não sublinhados (não codificados/anotados/atribuídos a casos). Você verá o deslocamento de sublinhados como texto é adicionado ou removido. +Você pode selecionar texto que não está sublinhado e copiar/substituir sem problemas. Você pode clicar em uma posição (**sem selecionar texto**) para então digitar, excluir ou colar texto. Isto pode ocorrer em locais de texto sublinhados (codificados, anotados, atribuídos a casos) ou não sublinhados (não codificados/anotados/atribuídos a casos). Você verá o deslocamento de sublinhados conforme se adicona ou remove texto. -!!!! "Existem algumas limitações" - Existem algumas limitações: É melhor evitar selecionar seções de texto para excluir (ou digitar ou colar) se essas seções tiverem uma combinação de não sublinhado (não codificado/anotado/atribuído caso) e sublinhado (codificado, anotado, atribuído caso). A razão é que as posições dos códigos/anotações subjacentes/caixa atribuída podem não corresponder correctamente ao previsto. Se você fez uma alteração que você acha que afetou estas posições codificadas/anotadas/atribuídas mal, saia da janela de edição de texto pressionando o botão Cancelar. +!!! warning "Existem algumas limitações" + É melhor evitar selecionar seções de texto para excluir (ou digitar ou colar) se essas seções tiverem uma combinação de não-sublinhado (não codificado/anotado/atribuído caso) e sublinhado (codificado, anotado, atribuído caso). A razão é que as posições dos códigos/anotações subjacentes/caixa atribuída podem não corresponder corretamente ao previsto. Se você fez uma alteração que você acha que afetou estas posições codificadas/anotadas/atribuídas de modo ruim, saia da janela de edição de texto clicando no botão Cancelar. ## Arquivos de exemplo {#example-files} -Existem arquivos de exemplo na pasta Exemplos. Estes podem ser usados para testar a importação de arquivos de diferentes formatos de documento e de importar uma imagem. Existem também arquivos de exemplo para testar os atributos de importação de casos, e para importar uma pesquisa. +Existem arquivos de exemplo na pasta `Examples`. Estes podem ser usados para testar a importação de arquivos de diferentes formatos de documento e de uma imagem. Existem também arquivos de exemplo para testar os atributos de importação de casos, e para importar uma _survey_. -## Gerenciar Links Maus para Arquivos {#manage-bad-links-to-files} +## Gerenciar Links ruins para Arquivos {#manage-bad-links-to-files} -Se seu projeto contém arquivos conectados externamente, esses arquivos podem ser movidos, renomeados ou excluídos. +Se seu projeto contém arquivos vinculados externamente, esses arquivos podem ser movidos, renomeados ou excluídos. -O recurso Gerenciar links ruins permite editar o link existente e substituí-lo por um novo, encontrando o arquivo correto e sua localização. Links ruins afetam imagens, arquivos de áudio e vídeo. O texto não é impactado a menos que você precise revisar um documento de texto original. Isso porque o texto simples, no qual ocorre a codificação, é importado para o banco de dados QualCoder. +O recurso Gerenciar _links_ ruins permite editar o link existente e substituí-lo por um novo, encontrando o arquivo correto e sua localização. _Links_ ruins afetam imagens, arquivos de áudio e vídeo. O texto não é impactado a menos que você precise revisar um documento de texto original. Isso porque o texto simples, no qual ocorre a codificação, é importado para o banco de dados do QualCoder. -A pesquisa automatizada leva tempo e procura no diretório do usuário até 2 nomes de arquivos correspondentes. Isto pretende acelerar a busca do link para arquivos onde o link está apontando para nada. \ No newline at end of file +A pesquisa automatizada leva tempo e procura no diretório do usuário por até 2 nomes de arquivos correspondentes. Isto pretende acelerar a busca do _link_ para arquivos nos quais o _link_ está apontando para nada. \ No newline at end of file diff --git a/docs/doc/pt/3.3.-Cases.md b/docs/doc/pt/3.3.-Cases.md index 50739be8..27594d3e 100644 --- a/docs/doc/pt/3.3.-Cases.md +++ b/docs/doc/pt/3.3.-Cases.md @@ -2,30 +2,30 @@ path: 3.3.-Cases --- -# Gerenciar casos +# Gerenciando casos -Casos são úteis para coligir vários arquivos para uma determinada circunstância ou pessoa. Os casos podem ter atributos como idade e sexo para os participantes. Você pode adicionar um memorando de notas a cada caso e renomear um caso clicando duas vezes em um nome de caso. Nem todos os projetos precisam de casos, por exemplo, um projeto de entrevistas individuais seria carregado como transcrições de texto individuais, e esses arquivos podem ser atribuídos atributos em Manage Files , como papel de uma pessoa, idade, etc. +Casos são úteis para coligir vários arquivos para uma determinada circunstância ou pessoa. Os casos podem ter atributos como idade e gênero para os participantes. Você pode adicionar um memorando de notas a cada caso e renomear um caso clicando duas vezes em um nome de caso. Nem todos os projetos precisam de casos, por exemplo, um projeto de entrevistas individuais seria carregado como transcrições de texto individuais, e esses arquivos podem receber atribuídos atributos em Gerenciar Arquivol, como o papel de uma pessoa, idade, etc. -Uma tabela lista os casos e seus atributos. O número de arquivos associados a um caso é mostrado. Clique na célula Arquivos na tabela para adicionar ou alterar arquivos associados a esse caso. Isto mostra a janela do gestor de ficheiros, descrita abaixo. +Há uma tabela que lista os casos e seus atributos. Nela, o número de arquivos associados a um caso é mostrado. Clique na célula Arquivos na tabela para adicionar ou alterar arquivos associados a esse caso. Isto mostrará a janela do Gerenciador de Arquivos, descrita abaixo. -Quando uma pesquisa é importada, cada linha de pesquisa pode ser atribuída a um caso. O nome do caso é o identificador único na primeira coluna da planilha csv ou Excel. Grandes pesquisas (por exemplo, 1000 ou mais linhas) podem levar muito tempo para importar, pois os casos levam algum tempo para criar. +Quando uma _survey_ é importada, cada linha da _survey_ pode ser atribuída a um caso. O nome do caso é o identificador único na primeira coluna da planilha csv ou Excel. Grandes _surveys_ (por exemplo, 1000 ou mais linhas) podem demorar muito para importar, pois os casos levam algum tempo para criar. -![imagem](/images/a2076cfb-da5e-486f-a443-6ef6a070fc9a.png) +![image](/images/a2076cfb-da5e-486f-a443-6ef6a070fc9a.png) -## Esconder e mostrar linhas e colunas {#hiding-and-showing-rows-and-columns} +## Ocultar e mostrar linhas e colunas {#hiding-and-showing-rows-and-columns} -Ocultar colunas com o botão direito do mouse na linha de cabeçalho da tabela para opções para ocultar essa coluna ou para ocultar colunas começando com texto específico. Ou para mostrar colunas começando com um valor de texto. Ocultar linhas pelo menu com o botão direito do mouse e selecionar um valor de texto que seja igual ou 'é como' algum texto escolhido. Clique com o botão direito para encomendar pelo nome do caso ou pelo valor do atributo, ascendente ou descendente. +Oculte colunas com o botão direito do _mouse_ no cabeçalho da tabela para as opções para ocultar essa coluna ou para ocultar colunas começando com texto específico. Ou para mostrar colunas começando com um valor de texto. Oculte linhas pelo menu com o botão direito do _mouse_ e selecione um valor de texto que seja igual ou 'é como' algum texto escolhido. Clique com o botão direito para ordenar pelo nome do caso ou pelo valor do atributo, ordem ascendente ou ordem descendente. !!! example "Exemplo prático" - Adicione os três alunos (ou casos) clicando no ícone Adicionar caso. Nome de cada estudante: ID1, ID2 e ID3. + Adicione os três alunos (ou casos) clicando no ícone Adicionar caso. Nomeie cada estudante: ID1, ID2 e ID3. ## Gerenciador de arquivos de casos {#case-file-manager} -Agora, adicione o arquivo de cada estudante a cada estudante. Clique na célula na coluna Arquivos para o caso ID3 por exemplo. Isto abre a janela do gestor de ficheiros casos . Em alternativa, clique no ícone de documentos que também abrirá o gerenciador de arquivos de caso. +Agora, adicione o arquivo de cada estudante a cada caso de estudante. Clique na célula na coluna Arquivos para o caso ID3, por exemplo. Isto abre a janela do _gerenciador de arquivos de casos_. Você pode também, clicar no ícone de documentos, o que também abrirá o gerenciador de arquivos de caso. ![imagem](/images/a322b68d-8f3a-49ec-ab9f-39bd67253d3e.png) -No gerenciador de arquivos case , clique em um caso, diga ID3, em seguida, clique no botão Adicionar arquivos selecionados para o caso. Selecione um ou mais arquivos na lista de arquivos. Adicione os arquivos à caixa. Por exemplo, adicione o miguel-henriques.jpg ao ID3. Você pode remover arquivos e visualizar os arquivos associados ao caso. Você verá que o texto do arquivo será sublinhado em vermelho, o que indica que este texto está associado a este caso. +No gerenciador de arquivos de caso, clique em um caso, digamos ID3, em seguida, clique no botão Adicionar arquivos selecionados para o caso. Selecione um ou mais arquivos na lista de arquivos. Adicione os arquivos à caixa. Por exemplo, adicione `miguel-henriques.jpg` ao ID3. Você pode remover arquivos e visualizar os arquivos associados ao caso. Você verá que o texto do arquivo será sublinhado em vermelho, o que indica que este texto está associado a este caso. Você também pode selecionar um caso, destacar manualmente partes de texto dentro de um documento de texto maior, e clicar com o botão direito para marcar – ou atribuir – o texto para o caso selecionado. @@ -34,9 +34,9 @@ Você também pode selecionar um caso, destacar manualmente partes de texto dent Você pode importar atributos de um arquivo CSV ou XLSX usando este botão: ![imagem](/images/0b9d8a34-33ff-4591-ae6d-c6f43bfb9625.png) -A primeira linha deve conter os cabeçalhos dos atributos. A primeira coluna deve conter nomes de casos correspondentes (para este exemplo: ID1, ID2, ID3). Note que este caso é sensível. Abra o arquivo cases.csv na pasta Exemplos para ver como ele é definido. +A primeira linha deve conter os cabeçalhos dos atributos. A primeira coluna deve conter os nomes dos casos correspondentes (para este exemplo: ID1, ID2, ID3). Note que os nomes são sensíveis à capitulação do texto (caixa_baixa ≠ CAIXA_ALTA). Abra o arquivo `cases.csv` na pasta `Examples` para ver como ele é definido. -Para este exemplo – excluir todos os casos mostrados. Em seguida, importe os atributos do arquivo cases.csv através da janela Importar Atributos. Você precisará novamente ligar os arquivos e o texto do arquivo a cada caso. +Para este exemplo – exclua todos os casos mostrados. Em seguida, importe os atributos do arquivo `cases.csv` por meio da janela Importar Atributos. Você precisará novamente ligar os arquivos e o texto do arquivo a cada caso. ## Exportar informações sobre os casos {#exporting-case-information} diff --git a/docs/doc/pt/3.4.-Attributes.md b/docs/doc/pt/3.4.-Attributes.md index df77cfcf..a7ef4270 100644 --- a/docs/doc/pt/3.4.-Attributes.md +++ b/docs/doc/pt/3.4.-Attributes.md @@ -4,16 +4,16 @@ path: 3.4.-Attributes # Atributos -Atributos são variáveis associadas a arquivos, casos ou periódicos. Eles podem ser úteis para adicionar contexto ao interpretar sua análise. Abre a janela para Gerenciar Atributos. Você pode adicionar, excluir, renomear e adicionar notas de memorando aos atributos. Você pode clicar com o botão direito em um atributo numérico para converter para Caracter, mas não de Caracter para Numérica. +Atributos são variáveis associadas a arquivos, casos ou diários. Eles podem ser úteis para adicionar contexto ao interpretar sua análise. Abra a janela Gerenciar Atributos. Você pode adicionar, excluir, renomear e adicionar notas de memorando aos atributos. Você pode clicar com o botão direito em um atributo numérico para convertê-lo para Caracter, mas não de Caracter para Numérico. -As únicas opções para atributos são numéricas e caracteres. Não há opções para booleanos, data ou hora ou tipos numéricos específicos, como inteiros. No entanto, se você estiver executando consultas SQL, via Relatórios > Consultas de banco de dados, você pode precisar lançar o atributo numérico para um Integer ou Real, por exemplo, cast(my var como inteiro). +As únicas opções para atributos são numéricps e caracteres. Não há opções para booleanos, data e hora ou tipos numéricos específicos, como inteiros. No entanto, se você estiver executando consultas SQL, via Relatórios > Consultas ao banco de dados, você pode precisar lançar (_cast_) o atributo numérico para um inteiro(_Integer_) ou Real, por exemplo, `cast(my_var as integer)`. -Atributos podem ser adicionados nas seções Gerenciar Atributos, Gerenciar Arquivos, Gerenciar Casos ou Gerenciar Diários clicando no botão (x), mostrado abaixo. Atributos podem ser importados de uma pesquisa, e também de um arquivo de projeto REFI-QDA. Nota A importação do projeto REFI-QDA não é garantida para importar com sucesso. +Atributos podem ser adicionados nas seções Gerenciar Atributos, Gerenciar Arquivos, Gerenciar Casos ou Gerenciar Diários clicando no botão _(x)_, mostrado abaixo. Atributos podem ser importados de uma pesquisa, e também de um arquivo de projeto REFI-QDA. Nota que a importação do projeto REFI-QDA não é garantida de ser bem-sucedidada. -Não é intenção da QualCoder realizar análises estatísticas dos atributos. Usar software estatístico como [R](https://www.r-project.org/). +Não é intenção do QualCoder realizar análises estatísticas dos atributos. Use _software_ estatístico como a linguagem [R](https://www.r-project.org/). Atributos também podem ser adicionados ou excluídos usando a opção Gerenciar > Gerenciar Atributos: ![imagem](/images/513af5f1-a94e-4606-b4d0-54011a8607da.png) -Nesta área você pode excluir atributos. Mas mesmo que você possa excluir atributos de referência, recomendamos que você não faça isso, a menos que tenha certeza de que todas as suas referências não são necessárias. Estes são prefixados com 'Ref ' e estão associados com referências importadas que ligam um arquivo a uma referência específica. Consulte Gerenciar Referências para importar e vincular referências a arquivos. \ No newline at end of file +Nesta área você pode excluir atributos. Mas mesmo que você possa excluir atributos de referência, recomendamos que você não faça isso, a menos que tenha certeza de que todas as suas referências não são necessárias. Estes são prefixados com `'Ref_'` e estão associados com referências importadas que ligam um arquivo a uma referência específica. Veja [Gerenciar Referências](3.5.-References.md#referências) para importar e vincular referências a arquivos. \ No newline at end of file diff --git a/docs/doc/pt/3.5.-References.md b/docs/doc/pt/3.5.-References.md index 31500306..bb0d9bab 100644 --- a/docs/doc/pt/3.5.-References.md +++ b/docs/doc/pt/3.5.-References.md @@ -4,23 +4,25 @@ path: 3.5.-References # Referências -Ir para Gerenciar > Referências para importar uma bibliografia. Isto deve estar no texto simples formatado RIS ou NBIB. O arquivo pode ter terminações de .txt ou .ris ou .nbib. Você também pode importar referências do Zotero 7 - garantir que o Zotero esteja aberto e rodando primeiro, e habilitar a API local em Configurações do Zotero - para permitir que o QualCoder se comunique com o Zotero. Os arquivos de referência PDF ou EPUB no Zotero também serão importados. +Vá em Gerenciar > Referências para importar uma bibliografia. Isto deve ser texto simples formatado em RIS ou NBIB. O arquivo pode ter as extensões `.txt` ou `.ris` ou `.nbib`. Você também pode importar referências do Zotero 7 - garanta que o Zotero esteja aberto e rodando primeiro, e habilite a API local em Configurações do Zotero - para permitir que o QualCoder se comunique com o Zotero. Os arquivos de referência PDF ou EPUB do Zotero também serão importados. + + ![imagem](/images/gh-c750c125-1214-466c-9d1f-c549c3a1ad15.png) -Pressione o botão de importação e selecione um arquivo de bibliografia (.txt, .nbib., .ris). Este exemplo foi de um arquivo de texto com uma referência em formato ris - veja pasta Exemplos bibliografia. Ris . As opções são importar todas, novas referências ou referências específicas. Se houver anexos, como com uma importação Zotero, estes também podem ser importados. +Pressione o botão importar e selecione um arquivo de bibliografia (`.txt`, `.nbib`, `.ris`). Este exemplo foi de um arquivo de texto com uma referência em formato ris - veja `Examples/bibliography.ris` na na pasta de exemplos. As opções são importar todas, novas referências ou referências específicas. Se houverem anexos, assim como com em uma importação do Zotero, estes também podem ser importados. ![img](/images/650842457-6a209439-d45c-4e13-8138-5c4dae03e8bd.png) -Você pode vincular e desconectar referências a arquivos. Você pode editar manualmente uma referência importada. Você pode excluir uma referência. +Você pode vincular e desconectar referências e arquivos. Você pode editar manualmente uma referência importada. Você pode excluir uma referência. -Na tela Gerenciar arquivos haverá quatro novas colunas de atributos: Ref Autors, Ref Título, Ref Type, Ref Year +Na tela Gerenciar Arquivos haverá quatro novas colunas de atributos: `Ref_Authors` (para os autores), `Ref_Title` (para o título), `Ref_Type` (para o tipo de referência - artigo, capítulo, livro, resenha, etc), `Ref_Year` (para o ano) ![imagem](/images/3d85d09f-926c-46df-87cb-867ad8dce4c1.png) -Os arquivos ligados a referências terão detalhes nessas colunas. +Os arquivos ligados a referências terão seus detalhes nessas colunas. -Referências podem ser exibidas em análise - como Análise - Recuperação de Código +Referências podem ser exibidas em análises - como em Análise - Recuperação de Código -Você pode exportar todas as referências ao formato ris com o botão exportar. \ No newline at end of file +Você pode exportar todas as referências em formato ris com o botão exportar. \ No newline at end of file diff --git a/docs/doc/pt/4.1.-Coding-Text.md b/docs/doc/pt/4.1.-Coding-Text.md index 6073906b..6b971b8b 100644 --- a/docs/doc/pt/4.1.-Coding-Text.md +++ b/docs/doc/pt/4.1.-Coding-Text.md @@ -2,30 +2,30 @@ path: 4.1.-Coding-Text --- -# Texto de Codificação +# Codificar Texto Selecione o texto do código no menu Coding. Uma vez que os segmentos de texto são codificados, passar o mouse sobre a codificação mostra o nome de código como uma dica. Clicando no segmento codificado também mostra o nome de código. -![imagem](/images/6f26284e-0802-4bd8-a75d-6b0e6562901c.png) +![image](/images/6f26284e-0802-4bd8-a75d-6b0e6562901c.png) -O texto codificado pode ser destacado através de um sublinhado, ou um estilo de marcador: +O texto codificado pode ser destacado através de um sublinhado, ou um estilo de marcação: -![imagem](/images/50bb8b05-73e9-41d8-9844-1ada6378d8a7.png) +![image](/images/50bb8b05-73e9-41d8-9844-1ada6378d8a7.png) -![imagem](/images/750bb5f3-5c81-493a-a4ee-85a94874070b.png) +![image](/images/750bb5f3-5c81-493a-a4ee-85a94874070b.png) -Selecionar um arquivo +_Selecionar um arquivo_ -Selecione um arquivo para codificação na lista de seleção no painel superior esquerdo. Abaixo estão botões que permitem que você mova para o próximo arquivo, para mover para o arquivo codificado mais recentemente e para ir para uma posição com favoritos em um arquivo, para ver o memorando de arquivo e um botão Atributos que filtra os arquivos com base em seus atributos. Além disso, há um menu com o botão direito do mouse de opções, incluindo ordenação. +Selecione um arquivo para codificação na lista de seleção no painel superior esquerdo. Abaixo estão botões que permitem que você acesse o próximo arquivo, para mover para o arquivo codificado mais recente e para ir para uma posição marcada como favoritos em um arquivo, para ver o memorando de arquivo e um botão Atributos que filtra os arquivos com base em seus atributos. Além disso, há um menu de opções com o botão direito do _mouse_, o qual inclui ordenação. -Criar um código +_Criar um código_ -Criar um novo código clicando com o botão direito no painel inferior esquerdo da janela. Os códigos podem ser atribuídos uma cor clicando com o botão direito do mouse no código e selecionando a opção de mudança de cor do código. Existe um botão na secção do cabeçalho com uma imagem de paleta de artista que irá definir todos os códigos recém- criados para a sua cor seleccionada, em vez de atribuição de cores aleatórias. +Crie um novo código clicando com o botão direito no painel inferior esquerdo da janela. Os códigos podem ser atribuídos uma cor clicando com o botão direito do _mouse_ no código e selecionando a opção de mudança de cor do código. Existe um botão na seção do cabeçalho com uma imagem de Paleta de tintas que irá definir todos os códigos recém-criados para a sua cor selecionada, em vez de atribuição de cores aleatórias. -Clique com o botão direito em um código para mais opções de um menu: adicione um memorando a um código, delete um código, renomeie, adicione um novo código e adicione uma nova categoria, mostrando códigos como (um determinado nome), Mova um código ou categoria, adicione uma categoria, ordenar. +Clique com o botão direito em um código para mais opções de um menu: adicionar um memorando a um código, excluir um código, renomear, adicionar um novo código e adicione uma nova categoria, mostraar códigos como (um determinado nome), mover um código ou categoria, adicionar uma categoria, ordenar. -Codificar texto +_Codificar texto_ A maneira mais fácil de codificar texto, é selecionar algum texto, em seguida, clique com o botão esquerdo do mouse em um código na árvore de código. Alternativamente, selecione algum texto. Clique com o botão direito para abrir um menu e marcar o texto com opções como o código atual, códigos recentes, um novo código, código ir in vivo. @@ -35,203 +35,200 @@ Segmentos de texto codificados podem ser memorizados - através do menu com o bo Textos codificados importantes, como exemplos para um relatório, podem ser marcados Importante usando o menu com o botão direito do mouse quando no texto codificado e selecionando a opção Importante. O botão Star por baixo da árvore de códigos alterna entre mostrar todo o texto codificado e texto codificado marcado como importante. -Sobreposição de códigos +_Sobreposição de códigos_ Sobreposição de códigos pode ser difícil de ver claramente. As secções sobrepostas são sublinhadas. O cursor do rato irá mostrar texto codificado sobreposto. Você pode pressionar 'O' depois de clicar em uma seção sobreposta para percorrer os códigos nesse local. ## Anotações {#annotations} Adicione uma anotação (um memorando para um segmento de texto) a uma seleção de texto. Estes são úteis para explicar siglas e jargão. O texto ficará arrojado para marcar a posição da anotação. Para reabrir uma anotação, selecione alguns dos textos em negrito e clique com o botão direito para obter a opção Anotar. Em alternativa, clique no bloco de notas mais à esquerda e no botão lápis, ou pressione a tecla 'A'. Para remover uma anotação, abra a anotação e apague todo o texto. -![imagem](/images/104526a8-1bba-4dae-8bcd-43d2ddc5f9c8.png) +![image](/images/104526a8-1bba-4dae-8bcd-43d2ddc5f9c8.png) -## Auto- código {#auto-code} +## Codificação automática {#auto-code} -O canto superior direito da tela tem botões para o texto de codificação automática: -![botões de código automático](/images/d689c833-505f-49e4-938c-e392d4a2cc14.png) +O canto superior direito da tela tem botões para a codificação automática de texto: +![botões de Codificação automática](/images/d689c833-505f-49e4-938c-e392d4a2cc14.png) Você pode: -* Auto- código texto exato. Uma janela extra irá perguntar quais arquivos você deseja auto-codificar. +* Codificar automaticamente texto exato. Uma janela extra irá perguntar quais arquivos você deseja auto-codificar. -* auto- codificar frases com base num fragmento de texto. Uma janela extra irá perguntar quais arquivos você deseja auto-codificar. +* Codificar automaticamente com base em um fragmento de texto. Uma janela extra irá perguntar quais arquivos você deseja auto-codificar. -* Codifique automaticamente o arquivo atual usando as marcas de texto inicial e final. Você pode usar ‘\n’ para um caractere final de linha. O texto da marca inicial está incluído na seção codificada. +* Codificar automaticamente o arquivo atual usando as marcas de texto inicial e final. Você pode usar ‘\n’ para um caractere final-de-linha. O texto da marca inicial está incluído na seção codificada. * Desfazer a codificação automática anterior -* Uma caixa de seleção para ativar o Regex. Esta é uma função especial para aplicar uma codificação automática mais flexível com base em wildcards e outras funções. Vê isto? [memorando](https://techearl.com/regex-cheat-sheet). +* Uma caixa de seleção para ativar o Regex. Esta é uma função especial para aplicar uma codificação automática mais flexível com base em _wildcards_ e outras funções. Veja este [memorando](https://techearl.com/regex-cheat-sheet). -A codificação automática é sensível a maiúsculas. Você também deve definir o fim de uma frase, há uma configuração padrão com um período e espaço. \n pode ser usado também para denotar um caractere final de linha. +A codificação automática é sensível à capitulação do texto. Você também deve definir o fim de uma frase, há uma configuração padrão com um ponto final e espaço. \n pode ser usado também para denotar um caractere final-de-linha. -Para auto-codificar correspondências de texto exatas, várias seções de texto podem ser atribuídas pelo código automático usando o símbolo de tubo ''. Por exemplo, políticos podem ser atribuídos ao mesmo código ao mesmo tempo (para o texto de código automático exato corresponde apenas). Existe uma opção de desfazer a auto-codificação realizada recentemente. Embora se o projeto for fechado e reaberto, a opção desfazer será perdida. +Para auto-codificar correspondências de texto exatas, várias seções de texto podem ser atribuídas pela codificação automática usando o símbolo de _pipe_ (barra vertical) '|'. Por exemplo, políticos podem ser atribuídos ao mesmo código ao mesmo tempo (para o texto de código automático exato corresponde apenas). Existe uma opção de desfazer a auto-codificação realizada recentemente. Embora se o projeto for fechado e reaberto, a opção desfazer será perdida. -O botão Auto-code text exato e o botão Auto-code text fragment tem um menu com o botão direito do mouse para mais opções. O padrão é codificar automaticamente todo o texto. Existem opções para autocodificar apenas o primeiro texto correspondente ou o último texto correspondente no documento. Outra opção é aplicar o código automático somente se ele aparecer dentro de outro código (por exemplo, dentro de um texto de alto-falante codificado). Os botões de texto e fragmento de texto exatos do código automático perguntam quais arquivos você quer codificados automaticamente. +O botão Codificar texto exato automaticamente e o botão Codificar framgmento de texto automaticamente têm um menu com o botão direito do _mouse_ para mais opções. O padrão é codificar automaticamente todo o texto. Porém, existem opções para autocodificar apenas o primeiro texto correspondente ou o último texto correspondente no documento. Outra opção é aplicar a codificação automática somente se ele aparecer dentro de outro código (por exemplo, dentro de um texto de interlocutor codificado). Os botões codificar texto exato automaticamente codificar framgmento de texto automaticamente perguntam quais arquivos você quer codificar automaticamente. -Existe um botão de desfazer para remover as auto-codificações que foram aplicadas pela última vez. +Existe um botão de desfazer para remover as auto-codificações que foram aplicadas por último. -** Emoji's , emoticons em texto e auto-codificação** +**Emoji's, emoticons em texto e auto-codificação** - Os caracteres emoji podem contar como 1 caractere em uma string, mas ocupam 2 ou mais posições no editor visual, levando a cálculos incorretos. Aplicar o código automático significa que pode haver uma mudança de posições de caracteres ao aplicar o código automático ao texto. + Os caracteres emoji podem contar como 1 caractere em uma _string_, mas ocupam 2 ou mais posições no editor visual, levando a cálculos incorretos. Aplicar a codificação automática significa que pode haver uma mudança de posições de caracteres ao aplicar a codificação automática ao texto. - Exemplo auto-codificação da palavra 'música', cada emoji é mostrado como 'um' caractere, mas nos bastidores são 2 caracteres. Isso pode resultar em uma mudança, visto abaixo: + Exemplo da auto-codificação da palavra 'música', cada emoji é mostrado como 'um' caractere, mas nos bastidores são 2 caracteres. Isso pode resultar em uma mudança como se vê abaixo: -![imagem](/images/8ac5bcf5-fae4-4da3-a1dd-8dccf12d585b.png) +![image](/images/8ac5bcf5-fae4-4da3-a1dd-8dccf12d585b.png) ## Codificações de colunas automáticas {#auto-speaker-codings} -A função "marca falantes" cria códigos para cada falante em uma entrevista ou discussão em grupo, e atribui enunciados automaticamente. Isto permite mais relatórios focados, apenas olhando para certos oradores de cada vez. Você pode alcançar a função através do menu de contexto do arquivo ou do seguinte botão da barra de ferramentas: +A função "Marcar Interlocutores" cria códigos para cada interlocutor em uma entrevista ou discussão em grupo, e atribui enunciados automaticamente. Isto permite mais relatórios focados, apenas olhando para certos oradores de cada vez. Você pode alcançar a função através do menu de contexto do arquivo ou do seguinte botão da barra de ferramentas: -![imagem](/images/645f0a43-4814-466e-a8a0-10758b910bb0.png) +![image](/images/645f0a43-4814-466e-a8a0-10758b910bb0.png) -- O nome do alto-falante deve estar no início de uma nova linha e ter menos de 64 caracteres. Os seguintes formatos são detectados: "Nome:", "{Nome}" ou "[Nome]" +- O nome do interlocutor deve estar no início de uma nova linha e ter menos de 64 caracteres. Os seguintes formatos são detectados: "Nome:", "{Nome}" ou "[Nome]" - Você pode selecionar quais nomes você deseja incluir e até mesmo editar o rótulo: -![imagem](/images/67c14d0f-2c9a-4e99-8907-9c16a32b6285.png) +![image](/images/67c14d0f-2c9a-4e99-8907-9c16a32b6285.png) -- Cada alto-falante terá seu próprio código na categoria especial "" alto-falantes"" no fundo da árvore de código. As cores padrão são do espectro cinzento, para torná-las menos distraídoras. -- No entanto, você ainda pode optar por esconder esses códigos na janela de texto, para que eles não distraiam você em sua própria codificação analítica. Para fazer isso, clique no botão "..." ao lado do nome do codificador no canto superior esquerdo da barra de ferramentas. No diálogo a seguir, selecione a entrada de "codificação do alto-falante" e defina a visibilidade para "escondido". -- A função "marcar alto-falantes" também está disponível no espaço de trabalho "gerir arquivos". +- Cada interlocutor terá seu próprio código na categoria especial "📌interlocutores" no fundo da árvore de código. As cores padrão são em escalas de cinza, para torná-las uma distração menor. +- No entanto, você ainda pode optar por ocultar esses códigos na janela de texto, para que eles não distraiam você em sua própria codificação analítica. Para fazer isso, clique no botão "..." ao lado do nome do codificador no canto superior-esquerdo da barra de ferramentas. No diálogo a seguir, selecione a entrada de "📌codificação do interlocutor" e defina a visibilidade para "oculto". +- A função "marcar interlocutors" também está disponível no espaço de trabalho "Gerenciar Arquivos". -## Maximizar a área do ecrã {#maximise-screen-area} +## Maximizar a área de tela {#maximise-screen-area} Para ocultar o painel de controle superior, clique na área de texto e pressione a tecla 'H'. Para mostrar o painel superior, pressione 'H' novamente. ## Métodos de conveniência para carregar arquivos de texto no painel da lista de arquivos. {#convenience-methods-for-loading-text-files-in-the-files-list-pane} -Alguns projetos podem ter muitos arquivos de texto e a janela de visualização de arquivos pode apresentar muitos arquivos para serem abertos. Clique com o botão direito do mouse nos arquivos no botão árvore de arquivos para ir para o próximo arquivo, ir para o arquivo com favoritos ou ir para o arquivo com os códigos mais recentes: - -* O próximo ficheiro alfabeticamente, +Alguns projetos podem ter muitos arquivos de texto e a janela de visualização de arquivos pode apresentar muitos arquivos para serem abertos. Clique com o botão direito do _mouse_ nos arquivos no botão árvore de arquivos para ir para o próximo arquivo, ir para arquivo marcado como favorito ou ir para o arquivo com os códigos mais recentes: +* O próximo arquivo alfabeticamente, * Selecione o arquivo que foi codificado mais recentemente, -* Ir para uma localização marcada num ficheiro. Para criar um favorito, clique com o botão direito em algum texto ao codificar e selecione a opção favorito. O favorito funciona apenas para um projeto de cada vez, então se você abrir um projeto diferente, o favorito estará incorreto ou pode não funcionar. +* Ir para uma localização marcada num arquivo. Para criar um favorito, clique com o botão direito em algum texto ao codificar e selecione a opção favorito. O favorito funciona apenas para um projeto de cada vez, então se você abrir um projeto diferente, o favorito estará incorreto ou pode não funcionar. ### Botões de conveniência abaixo da lista de arquivos {#convenience-buttons-underneath-the-files-list} -* Carregar o próximo ficheiro -* Carregar o ficheiro com a última codificação +* Carregar o próximo arquivo +* Carregar o arquivo com a última codificação * Ir para o arquivo de favoritos atual -* Abre o memorando do ficheiro seleccionado -* Use uma função de filtro mostrar apenas os arquivos que atendem a determinados critérios. Estes podem ser de atributos de arquivo, ou se os arquivos estão associados a certos casos. (Imagem abaixo) +* Abrir o memorando do arquivo selecionado +* Usar uma função de filtro mostrar apenas os arquivos que atendem a determinados critérios. Estes podem ser de atributos de arquivo, ou se os arquivos estão associados a certos casos. (Imagem abaixo) -![imagem](/images/b3c32938-c1df-455c-be3e-3753c813535c.png) +![image](/images/b3c32938-c1df-455c-be3e-3753c813535c.png) ## Modificando posições de código {#modifying-code-positions} Clique com o botão direito em um código e selecione Redimensionar. As alças em cada extremidade do segmento codificado podem ser reposicionadas. -![imagem](/images/8b9e09f0-03e0-4ad1-8042-f7aa5ce12b31.png) +![image](/images/8b9e09f0-03e0-4ad1-8042-f7aa5ce12b31.png) -Alternativamente, clique em um código com o mouse (Note que o código não deve ser sobreposto com outro código nessa posição). Pressione as seguintes combinações de teclas para estender ou encolher o segmento de texto codificado. +Alternativamente, clique em um código com o _mouse_ (Note que o código não deve ser sobreposto com outro código nessa posição). Pressione as seguintes combinações de teclas para estender ou encolher o trecho de texto codificado. -* Shift + seta esquerda Extende o texto codificado para a esquerda -* Shift + seta direita Extende o texto codificado para a direita -* Alt + seta esquerda encolhe texto codificado do lado direito para a esquerda -* Alt + seta direita encolhe texto codificado do lado esquerdo para a direita +* Shift+seta esquerda Extende o texto codificado para a esquerda +* Shift+seta direita Extende o texto codificado para a direita +* Alt+seta esquerda encolhe texto codificado do lado direito para a esquerda +* Alt+seta direita encolhe texto codificado do lado esquerdo para a direita -É sempre melhor salvar uma cópia do projeto antes de editar o texto, para evitar a necessidade de editar posições de codificação, no caso de depois de editar texto as posições de codificação são deslocadas incorretamente. As teclas abaixo podem ajudar a recuperar as posições corretas. +É sempre melhor salvar uma cópia do projeto antes de editar o texto, para evitar a necessidade de editar posições de codificação, no caso de, depois de editar texto, as posições de codificação serem deslocadas incorretamente. As teclas abaixo podem ajudar a recuperar as posições corretas. -* Símbolo de hash \# Exibe a posição do caractere clicado. -* Dollar symbol $ Shift code positions, after the clicked character position. Pode ser necessário depois que o texto é editado (adicionado ou excluído) para mudar segmentos de codificação subsequentes por um número de caracteres. +* Jogo da Velha/Símbolo de _hash_ (\#) Exibe a posição do caractere clicado. +* Cifrão ($) Move as posições do código, após a posição do caracter clicado. Pode ser necessário depois que o texto é editado (adicionado ou excluído) para mover segmentos de codificação subsequentes por um número de caracteres. ## Outras teclas de atalho para codificação de texto {#other-shortcut-keys-for-text-coding} * A. Anotar o texto seleccionado -* B. Marque a localização atual no arquivo de texto atual. Mudar B para ir para o marcador. +* B. Marque a localização atual no arquivo de texto atual. Shift+B para ir para o marcador. * C. Na área de texto. Criar uma categoria. -* Ctrl E para entrar e sair Modo Editar. +* Ctrl+E para entrar e sair Modo Editar. * H. Ocultar e mostrar a seção superior dos controles na tela. Isso fornece uma área maior para ver o texto e para codificar. -* I. Numa secção codificada para marcar esse código como importante. Útil para identificar exemplos. Marcas importantes podem ser removidas clicando com o botão direito e selecionando Remover marca importante. Códigos importantes marcados são em negrito. +* I. Numa seção codificada marcar essa codificação como importante. Útil para identificar exemplos. Marcas importantes podem ser removidas clicando com o botão direito e selecionando Remover marcação como importante. Códigos marcados como importantes aparecem em negrito. * L. 'Mostrar códigos como', para mostrar uma lista curta na árvore de códigos. -* M. Memo um código. (Deve clicar sobre um segmento de texto codificado) +* M. Memorando de código. (Deve ter texto selecionado) * N. Na área de texto. Criar um novo código. -* O. Ciclo através de códigos sobrepostos in situ. (Deve clicar sobre um segmento de códigos sobreposto - denotado com um overline). +* O. Alternar entre códigos sobrepostos _in situ_. (Deve clicar sobre um segmento de códigos sobreposto - denotado com um _overline_). * P. Código rápido com o código mais recente. (Deve ter uma seleção de texto) -* R. Selecione códigos recentes. (Deve ter uma seleção de texto) - -* Ctrl R. Reverter a direcção do texto. Pode ser necessário para o árabe ou outros idiomas de direita para esquerda. +* Ctrl+R. Reverter a direcção do texto. Pode ser necessário para o árabe ou outros idiomas que são da direita para esquerda. -* S. Pesquisa texto. +* S. Pesquisar no texto. -* R. Abre códigos usados recentemente para marcar texto. +* R. Abre os códigos usados recentemente para marcar texto. (Deve ter texto selecionado). -* U. Desmarcar um ou mais códigos em uma posição de texto clicada. (Release 3.4 do CQ) +* U. Desmarcar um ou mais códigos em uma posição de texto clicada. (versão 3.4 do QC) -* V. Código texto selecionado com um novo código feito do texto selecionado. Também chamado * in vivo* codificação. +* V. Codificar texto selecionado com um novo código feito do texto selecionado. Também chamado codificação *in vivo*. -* Ctrl Z. Restaura o último código que não foi marcado. +* Ctrl+Z. Restaura o último código que não foi marcado. ## Procurar texto {#search-text} -O diálogo de texto de codificação contém uma busca por função de texto no meio superior, com as caixas de seleção para procurar case sensitive e para pesquisar através de todos os arquivos de texto. Quando na área de texto, selecionar algum texto e pressionar a tecla de atalho 's' irá preencher a caixa de texto de pesquisa e focar no botão de seta 'próximo' para olhar rapidamente através do documento para o texto selecionado. A busca requer um mínimo de 3 caracteres como padrão. Clique com o botão direito para alterar o padrão para 5 caracteres, ou para pesquisar apenas após Enter é pressionado. A caixa de seleção sensível ao Case limitar- se- á à pesquisa sensível ao Case. A caixa de seleção Todos os arquivos continuará a pesquisa através de outros arquivos de texto. +O diálogo de codificação de texto contém uma função de busca por texto na área meio-superior, com as caixas de seleção para buscas sensíveis à capitulação e para pesquisar em todos os arquivos de texto. Quando na área de texto, selecionar algum texto e pressionar a tecla 's' preenche a caixa de texto de pesquisa e foca no botão de seta 'próximo' para buscar rapidamente através do documento o texto selecionado. A busca requer um mínimo de 3 caracteres por padrão. Clique com o botão direito para alterar o padrão para 5 caracteres, ou para pesquisar apenas após Enter ser pressionado. A caixa de seleção Sensível à Capitulação limita-se à pesquisa sensível à Capitulação. A caixa de seleção Todos os arquivos continuará a pesquisa em outros arquivos de texto. -A pesquisa usa funções Regex. +A pesquisa usa funções de expressões regulares (Regex). -* Um ponto «.» é utilizado como uma carta selvagem, por exemplo, «.ears» corresponde a «ursos» e «anos». -* Um ‘?’ depois de um caractere combinar uma ou nenhuma vez esse caractere, por exemplo, ‘ursos?’ combinará ‘ursos’ e ‘ursos’ -* Um ‘*’ após um caractere irá corresponder zero ou mais vezes. -* «\. irá corresponder ao símbolo de ponto, '\?' irá corresponder ao ponto de interrogação. '\n' irá corresponder ao símbolo de fim de linha. Isto [Folha de fraude do Regex](www.rexegg.com/regex-quickstart.html) pode ajudar. +* O ponto final «.» é utilizado como _wildcard_, por exemplo, «.eio» corresponde a «feio» e «meio». +* ‘?’ depois de um caractere corresponde a sua aparição uma ou nenhuma vez, por exemplo, ‘ursos?’ combinará ‘urso’ e ‘ursos’ +* ‘*’ após um caractere a sua aparição zero ou mais vezes. +* ‘\.’ irá corresponder ao ponto final, '\?' irá corresponder ao ponto de interrogação. '\n' irá corresponder ao símbolo de fim de linha. Isto [Folha de fraude do Regex](www.rexegg.com/regex-quickstart.html) pode ajudar. * \b limite de palavra, '\bbound\b' irá procurar a palavra completa 'bound', mas não 'boundary' -## Movendo através do texto para um código selecionado {#moving-through-the-text-for-one-selected-code} +## Movendo-se pelo texto para um código selecionado {#moving-through-the-text-for-one-selected-code} Debaixo da árvore de códigos estão os botões: para frente, para trás e um botão de ícone de grade (para sair da função). -Selecione um código e, em seguida, clique nas setas para frente e para trás. Estes agora atravessam o documento de texto que mostra o texto codificado seleccionado. Todos os outros textos codificados estão escondidos. Para restaurar e mostrar todos os códigos, clique no botão da grade agora colorida. +Selecione um código e, em seguida, clique nas setas para frente e para trás. Estes agora atravessam o documento de texto, mostrando o texto codificado para o código selecionado. Todos os outros textos codificados ficam oculto. Para restaurar e mostrar todos os códigos, clique no botão da grade agora colorida. -!!! note - Na versão 4.0, todo o arquivo de texto é despachado. Nas versões anteriores, por exemplo, 3.8.2 havia uma opção para carregar um arquivo de texto em pedaços de 50.000 caracteres. Se você precisa carregar texto em blocos, então recomendamos que você use o anterior [QualCoder versão 3.8.2](https://github.com/ccbogel/QualCoder/releases/tag/3.8.2)No entanto, note que o carregamento de texto em PDF mudou de 3.8.2 para 4.0, o que pode causar imprecisão com as posições do segmento de codificação ao abrir um projeto mais novo (por exemplo, 4.0) na versão mais antiga (3.8.2 ou anterior). +!!! note "Nota" + Na versão 4.0, todo o arquivo de texto é mostrado. Nas versões anteriores, por exemplo, 3.8.2 havia uma opção para carregar um arquivo de texto em pedaços de 50.000 caracteres. Se você precisa carregar texto em blocos, então recomendamos que você use a [versão anterior do QualCoder (3.8.2)](https://github.com/ccbogel/QualCoder/releases/tag/3.8.2). No entanto, note que o carregamento de texto em PDF mudou entre a 3.8.2 e a 4.0, o que pode causar imprecisão com as posições do segmento de codificação ao abrir um projeto mais novo (por exemplo, 4.0+) na versão mais antiga (3.8.2 ou anterior). ## Mostrar apenas texto codificado importante {#show-only-important-coded-text} Sob a árvore de códigos está um botão com um símbolo de estrela. Este botão alterna entre mostrar todo o texto codificado e o texto codificado marcado como Importante. -## Relatórios de exportação {#export-reports} +## Exportar Relatórios {#export-reports} -Exportar em formato odt - compatível com LibreOffice e Microsoft Word. Ou com destaques de código, ou comentários ao lado. Relatório Odt contém detalhes de códigos usados, frequências, anotações, memorandos e texto codificado. Outras opções incluem texto simples, html e uma exportação de livro de códigos. +Exportar em formato odt - compatível com LibreOffice e Microsoft Word. Ou com marcações de código, ou comentários ao lado. Relatório Odt contém detalhes dos códigos usados, frequências, anotações, memorandos e texto codificado. Outras opções incluem texto simples, html e uma exportação do livro de códigos. ## Painel à direita {#right-hand-pane} -O lado direito do painel de texto de codificação tem outro painel escondido. Para abrir clique e arraste do lado direito da janela ou pressione o botão ao lado do botão Ajuda. Este painel contém opções úteis ao codificar. Um botão é ao clicar em um código, o nome de código, regra de código (memo) e exemplos de texto codificados aleatórios do projeto são exibidos. O outro botão exibe o memorando do projeto. +O lado direito do painel de codificação de texto tem outro painel escondido. Para abrir clique e arraste do lado direito da janela ou pressione o botão ao lado do botão Ajuda. Este painel contém opções úteis para a codificação. Um botão mostra, ao clicar em um código, o nome de código, regra de código (memorando) e exemplos de texto codificados aleatórios do projeto são exibidos. O outro botão exibe o memorando do projeto. -![imagem](/images/a6977ba3-bdf2-43c8-9097-562a252af815.png) +![image](/images/a6977ba3-bdf2-43c8-9097-562a252af815.png) -## Edição de texto quando em codificação - Texto de código {#editing-text-when-in-coding-code-text} +## Edição de texto quando em codificação - Codificar Texto {#editing-text-when-in-coding-code-text} -O texto pode ser editado mesmo após o texto ser codificado ou anotado ou atribuído (total ou parcialmente) a um caso. Seções do arquivo de texto ou arquivo áudio/vídeo transcrito terão seções de texto sublinhadas em verde (caso atribuído), amarelo (anotação) ou vermelho (codificado) por todos os codificadores. +O texto pode ser editado mesmo após o texto ser codificado ou anotado ou atribuído (total ou parcialmente) a um caso. Trechos do arquivo de texto ou arquivo áudio/vídeo transcrito terão trechos de texto sublinhados em verde (caso atribuído), amarelo (anotação) ou vermelho (codificado) - para todos os codificadores. !!! note - BEST PRÁTICA: Salve uma cópia do projeto antes de editar um arquivo de texto já codificado. Isto é apenas no caso de as posições do código serem reposicionadas incorretamente. + BOA PRÁTICA: Salve uma cópia do projeto antes de editar um arquivo de texto já codificado. Isto é apenas no caso de as posições das codificações serem reposicionadas incorretamente. Ao entrar no modo de edição, todo o arquivo é carregado para edição. Outras funções como a árvore de códigos e lista de arquivos são desativadas. -Você pode selecionar texto que não está sublinhado e copiar/substituir sem problemas. Você pode clicar em uma posição (sem selecionar texto) para então digitar, excluir ou colar texto. Isto pode ocorrer em locais de texto sublinhados (codificados, anotados, atribuídos a casos) ou não sublinhados (não codificados/anotados/atribuídos a casos). Você verá o deslocamento de sublinhados como texto é adicionado ou removido. +Você pode selecionar texto que não está sublinhado e copiar/substituir sem problemas. Você pode clicar em uma posição (sem selecionar texto) para então digitar, excluir ou colar texto. Isto pode ser feito em locais de texto sublinhados (codificados, anotados, atribuídos a casos) ou não sublinhados (não codificados/anotados/atribuídos a casos). Você verá o deslocamento de sublinhados conforme se adiciona ou remove texto. -Existem algumas limitações: É melhor evitar selecionar seções de texto para excluir (ou digitar ou colar). Trata-se, em particular, de uma questão se alguma dessas secções tiver sido sublinhada (codificada, anotada, atribuída). Pode também ser uma A razão é que as posições dos códigos/anotações subjacentes/case-atribuídos podem não corresponder corretamente como pretendido. +Existem algumas limitações: É melhor evitar selecionar seções de texto para excluir (ou digitar ou colar). Isso é particularmente um problema se alguma desses trechos tiver sido sublinhado (codificada, anotada, atribuída).Uma explicação possível é que as posições dos códigos/anotações subjacentes/case-atribuídos podem não corresponder corretamente como pretendido. -Se você fez uma alteração que você acha que afetou essas posições codificadas/anotadas/atribuídas mal, saia da janela de edição de texto. Em seguida, **antes de qualquer outra coisa é feito** pressione o botão desfazer (seta para trás) ao lado do botão Editar texto. +Se você fez uma alteração que você acha que afetou essas posições codificadas/anotadas/atribuídas de modo ruim, saia da janela de edição de texto. Em seguida, **antes de qualquer outra coisa ser feita** pressione o botão desfazer (seta para trás) ao lado do botão Editar texto. -![imagem](/images/d9496b21-a494-433f-84a5-cbac8419449f.png) +![image](/images/d9496b21-a494-433f-84a5-cbac8419449f.png) -!!! note - Nota importante: As edições ocorrem dentro do texto armazenado no banco de dados. O arquivo de texto original NÃO é alterado. +!!! note "Nota" + Importante: As edições ocorrem dentro do texto armazenado no banco de dados. O arquivo de texto original NÃO é alterado. -Abaixo está como a tela de texto de edição parece. +Abaixo está como a tela de edição de texto aparece. -![imagem](/images/b02d740e-d561-4c3c-aff0-637d45740d03.png) +![image](/images/b02d740e-d561-4c3c-aff0-637d45740d03.png) ## Categorias e códigos {#categories-and-codes} diff --git a/docs/doc/pt/4.2.-AI-Assisted-Coding.md b/docs/doc/pt/4.2.-AI-Assisted-Coding.md index d93056f3..5fe3bd37 100644 --- a/docs/doc/pt/4.2.-AI-Assisted-Coding.md +++ b/docs/doc/pt/4.2.-AI-Assisted-Coding.md @@ -2,31 +2,31 @@ path: 4.2.-AI-Assisted-Coding --- -# AI Codificação Assistida +# Codificação Assistida por IA ## Introdução {#introduction} -Os recursos de IA incorporados da QualCoder (versão 3.6 e up) podem auxiliar o processo de codificação de várias maneiras: +Os recursos de IA incorporados ao QualCoder (versão 3.6+) podem auxiliar o processo de codificação de várias maneiras: -- ** Pesquisa de IA:** Aproveite a capacidade da IA de analisar rapidamente grandes quantidades de texto para encontrar e explorar tópicos ou conceitos específicos dentro do seu corpus. -- ** Procurar conceitos, não palavras-chave: ** QualCoder usa uma combinação de tecnologias de busca semântica e modelos de linguagem grande como GPT-4. Como resultado, você não precisa digitar palavras-chave exatas, mas também pode procurar conceitos muito mais abstratos, por exemplo, "mudança de papéis de gênero" ou "reconhecimento no local de trabalho". +- **Pesquisa de IA:** Aproveite a capacidade da IA de analisar rapidamente grandes quantidades de texto para encontrar e explorar tópicos ou conceitos específicos dentro do seu _corpus_. +- **Procure conceitos, não palavras-chave:** O QualCoder usa uma combinação de tecnologias de busca semântica e modelos de linguagem em larga escala como o GPT-4. Como resultado, você não precisa digitar palavras-chave exatas, mas também pode procurar conceitos muito mais abstratos, por exemplo, "mudança de papéis de gênero" ou "reconhecimento no local de trabalho". - **Interprete seus dados interativamente com a IA:** A IA não só sugere dados relevantes, mas também fornece interpretação, oferecendo uma perspectiva diferente que pode enriquecer sua compreensão dos dados. -- ** Adapte-o à sua metodologia:** Dirige a análise da IA escolhendo entre vários prompts predefinidos ou criando o seu próprio. -- **Assistência, não codificação automatizada:** Ao contrário da palavra-chave [codificação automática](4.1.-Coding-Text#auto-code), este não é um processo automatizado. Tem de rever as sugestões da IA. +- **Adapte-a à sua metodologia:** Dirija a análise da IA escolhendo entre vários _prompts_ predefinidos ou criando o seu próprio. +- **Assistência, não codificação automatizada:** Ao contrário da [codificação automática](4.1.-Coding-Text#auto-code) baseada em palavra-chave, este não é um processo automatizado. Deves de rever as sugestões da IA. -Note-se que "AI Assisted Coding" não é um método por si só; é um conjunto de técnicas que podem ser adaptadas a muitos métodos que trabalham com códigos, desde teoria fundamentada até análise de conteúdo ou temática. Vê isto? [tutorial em vídeo]( https://www.youtube.com/watch?v=FrQyTOTJhCc) para um exemplo prático. +Note que a "Codificação Assistida por IA" não é um método por si só; é um conjunto de técnicas que podem ser adaptadas a muitos métodos que trabalham com códigos, desde teoria fundamentada até análise de conteúdo ou temática. Veja este [tutorial em vídeo]( https://www.youtube.com/watch?v=FrQyTOTJhCc) para um exemplo prático. ## Pré-condições {#preconditions} -- O IA deve ser ativado, totalmente carregado e pronto para novas consultas (veja a barra de status do estado atual). -- É ** Altamente recomendado** usar o memorando do projeto (Menu "AI > Memo do Projeto") para incluir uma breve descrição dos tópicos de pesquisa do seu projeto, questões, objetivos e os dados empíricos coletados. Essas informações acompanharão cada alerta enviado à IA, resultando em resultados muito mais direcionados. +- A IA deve estar ativada, totalmente carregada e pronta para novas consultas (veja a barra de _status_ para o estado atual). +- É **Altamente recomendado** usar o memorando do projeto (Menu "IA > Memorando do Projeto") para incluir uma breve descrição dos tópicos de pesquisa do seu projeto, questões, objetivos e os dados empíricos coletados. Essas informações acompanharão cada _prompt_ enviado à IA, resultando em resultados muito mais direcionados. ## Iniciar a codificação assistida por IA {#start-ai-assisted-coding} -A codificação assistida por IA está integrada no espaço de trabalho de codificação de texto. Comece clicando em "Coding > AI-assisted coding" ou, se você já estiver na área de trabalho de codificação de texto, selecione a guia "AI Assistance" à esquerda. Em seguida, clique em "Iniciar pesquisa de IA." +A codificação assistida por IA está integrada no espaço de trabalho de codificação de texto. Comece clicando em "Codificar > Codificação Assistida por IA" ou, se você já estiver na área de trabalho de codificação de texto, selecione a guia "Assistência de IA" à esquerda. Em seguida, clique em "Iniciar pesquisa de IA." -![Página de Assistência de I.A. de captura de tela](/images/1eeca42f-2e4e-48a6-aca7-68e4b13df6c4.png) +![Captura de Tela Página de Assistência de IA](/images/1eeca42f-2e4e-48a6-aca7-68e4b13df6c4.png) Na próxima janela, você tem que (1) definir o objeto de sua pesquisa (código ou tópico livre), (2) instruir a IA como analisar seus dados, e, se necessário, (3) definir filtros para seus dados: -![Janela de pesquisa da imagem IA](/images/0d66baa1-6c60-423a-b4d6-742d387322dc.png) +![Janela de pesquisa de imagem com IA](/images/0d66baa1-6c60-423a-b4d6-742d387322dc.png) ### 1) O que procurar: Código vs. Pesquisa de Tópico Livre {#1-what-to-search-for-code-vs-free-topic-search} @@ -36,53 +36,53 @@ Use isso para mergulhar mais profundamente em um aspecto particular e adicionar **Opções:** -- ** Selecione um código ou uma categoria:** QualCoder enviará não apenas o nome de código para a IA, mas o caminho de hierarquia completo na árvore de código, por exemplo, "Work > Significados de trabalho > Trabalhar como uma necessidade" no exemplo mostrado acima. +- **Selecionar um código ou uma categoria:** O QualCoder enviará não apenas o nome do código para a IA, mas a hierarquia completa na árvore de código, por exemplo, "Trabalho > Significados de trabalho > Trabalho como uma necessidade" no exemplo mostrado acima. - **Enviar memorando para IA:** Se selecionado, o memorando de código também será compartilhado com a IA. Use isso para descrever ou definir seu código e ajudar a IA a gerar melhores resultados. Se você também quiser adicionar notas pessoais ao memorando de código, você pode fazer isso inserindo "######" no texto. Qualquer coisa abaixo desta marca não será enviada para a IA. -- ** Incluir segmentos codificados:** Defaulted to off, significando que a pesquisa de IA irá retornar apenas novos dados ainda não codificados com este código particular. Ative esta opção para incluir também dados codificados anteriormente. +- **Incluir trechos codificados:** Desligada por padrão, ou seja, a pesquisa de IA irá retornar apenas novos dados ainda não codificados com este código particular. Ative esta opção para incluir também dados codificados anteriormente. -#### Pesquisa de Tópicos Grátis {#free-topic-search} -Procure qualquer tópico, fenômeno ou conceito em todo o seu corpus de dados sem um código predefinido. Digite um nome e uma descrição para comunicar à IA o que você está procurando. +#### Pesquisa de Tópicos Livres {#free-topic-search} +Procure qualquer tópico, fenômeno ou conceito em todo o seu _corpus_ de dados sem um código predefinido. Digite um nome e uma descrição para comunicar à IA o que você está procurando. ### 2) Como analisar os dados: O Prompt Analítico para a IA {#2-how-to-analyse-the-data-the-analytic-prompt-for-the-ai} -O prompt analítico instrui a IA a examinar seus dados. Selecione- o na parte inferior esquerda da janela. +O _prompt_ analítico instrui a IA a examinar seus dados. Selecione-o na parte inferior esquerda da janela. ![Seleção do Prompt Analítico](/images/83ab0d49-782d-420d-8088-9dec78e3e28e.png) -**QualCoder oferece uma gama de prompts analíticos para diferentes abordagens.** Estes permitem, por exemplo, modificar a pesquisa de IA para ser muito aberta, interpretativa e inclusiva ("prompt de pesquisa aberta") ou para ser mais focada, aderindo a regras de codificação predefinidas delineadas no memorando do código ("prompt de análise de conteúdo"). +**O QualCoder oferece uma gama de _prompts_ analíticos para diferentes abordagens.** Estes permitem, por exemplo, modificar a pesquisa de IA para ser muito aberta, interpretativa e inclusiva ("prompt de pesquisa aberta") ou para ser mais focada, aderindo a regras de codificação predefinidas delineadas no memorando do código ("prompt de análise de conteúdo"). -**Explore estes prompts** passando o mouse sobre os itens da lista suspensa. Clique em "Editar" para [editar os prompts analíticos ou definir o seu próprio](6.3.-AI-Prompt-Library) (opção avançada). +**Explore estes _prompts_** passando o mouse sobre os itens da lista suspensa. Clique em "Editar" para [editar os prompts analíticos ou definir o seu próprio](6.3.-AI-Prompt-Library) (opção avançada). -### 3) Filtro: Estreite sua busca para baixo {#3-filter-narrow-your-search-down} -Por padrão, o corpus completo de dados textuais no projeto atual é explorado. Se você quiser limitar a pesquisa a certos **documents** ou **cases**, você pode selecioná-los no lado direito da janela (Ctrl + Clique para selecionar múltiplos). Você também pode definir um filtro com base em ** variáveis de atributos selecionadas.** +### 3) Filtro: Estreite sua busca {#3-filter-narrow-your-search-down} +Por padrão, o _corpus_ completo de dados textuais no projeto atual é explorado. Se você quiser limitar a pesquisa a certos **documentos** ou **casos**, você pode selecioná-los no lado direito da janela (Ctrl + Clique para selecionar múltiplos). Você também pode definir um filtro com base em **variáveis de atributos selecionadas.** ## O processo de codificação assistida por IA {#the-process-of-ai-assisted-coding} Primeiro, realize a busca de IA. Este é um processo em duas etapas: -** Passo 1:** A IA consulta seu banco de dados local para dados potencialmente relevantes em seu corpus. +**Passo 1:** A IA consulta seu banco de dados local para dados potencialmente relevantes em seu _corpus_. -** Passo 2:** Estes dados são então enviados para o modelo de linguagem grande para uma análise detalhada com base no prompt selecionado. +**Passo 2:** Estes dados são então enviados para o modelo de linguagem em larga escala para uma análise detalhada com base no _prompt_ selecionado. Por favor, seja paciente, pois pode levar algum tempo para os resultados iniciais aparecerem. Clicando em um resultado carrega o documento na janela principal e destaca a citação relevante. Também certifique-se de olhar para o texto em torno da citação para entender o seu contexto. -### Trabalhar através dos Resultados {#working-through-the-results} +### Trabalhando com os Resultados {#working-through-the-results} -Você pode **codificar o texto selecionado** como faria qualquer outro texto no [espaço de trabalho código- texto](4.1.-Coding-Text). Expandir ou modificar a seleção conforme necessário. +Você pode **codificar o texto selecionado** como faria com qualquer outro texto no [espaço de trabalho codificar texto](4.1.-Coding-Text). Expanda ou modifique a seleção conforme necessário. -Você também pode visualizar a interpretação do **AI ** passando o mouse sobre um resultado na lista à esquerda, que exibirá uma janela de dicas. Se você optar por codificar o texto, você pode adicionar a interpretação da IA como um memorando ao código. +Você também pode visualizar a **interpretação da IA** passando o _mouse_ sobre um resultado na lista à esquerda, que exibirá uma janela de dicas. Se você optar por codificar o texto, você pode adicionar a interpretação da IA como um memorando ao código. ![Interpretação da IA](/images/83e4e641-1e9d-4b2c-b80d-6c6e5b7c2e97.png) -Quando você chegar ao ** fim da lista,** você verá frequentemente um link "encontrar mais", o que significa que mais dados do primeiro passo da pesquisa estão disponíveis para inspeção mais próxima. Clique neste link para examinar os próximos 10 pedaços de dados. +Quando você chegar ao **fim da lista**, você verá frequentemente um _link_ "encontrar mais", o que significa que mais dados do primeiro passo da pesquisa estão disponíveis para inspeção mais detalhada. Clique neste _link_ para examinar as próximas 10 partes dos dados. -QualCoder usa um algoritmo ** para exibir os resultados mais relevantes no topo da lista. Note que este algoritmo não é perfeito; você ainda pode encontrar dados interessantes mais abaixo na lista. +O QualCoder usa um **algoritmo de ranqueamento** para exibir os resultados mais relevantes no topo da lista. Note que esse algoritmo não é perfeito; você ainda pode encontrar dados interessantes mais abaixo na lista. -Ao longo do tempo, no entanto, os resultados retornados pela IA começarão a ** divergir do tópico original** e tornar-se cada vez menos relevante. Este é o ponto onde você deve parar a investigação e passar para o próximo tópico ou código. Você não precisa clicar em "encontrar mais" até que não haja absolutamente nenhum dado para analisar a partir do primeiro passo da pesquisa. Compare isso com uma pesquisa do Google: Não há necessidade de clicar em cada página de resultados se você já entender o que você quer saber. +Ao longo do tempo, no entanto, os resultados retornados pela IA começarão a **divergir do tópico original** e tornar-se cada vez menos relevantes. Este é o ponto onde você deve parar a investigação e passar para o próximo tópico ou código. Você não precisa clicar em "encontrar mais" até que não haja absolutamente nenhum dado para analisar a partir do primeiro passo da pesquisa. Pense nisso com uma pesquisa do Google: Não há necessidade de clicar em cada página de resultados se você já entendeu o que você quer saber. ### O que fazer se não obtiver resultados {#what-to-do-if-you-get-no-results} -1) **Se o passo não retornar quaisquer dados potencialmente relevantes:** Lembre-se que, por padrão, a pesquisa de código apenas extrai novos dados. Se você já codificou completamente seus documentos, pode simplesmente não haver nada novo para explorar em um determinado tópico. Além disso, pense sobre sua pesquisa, especialmente o nome do código ou tópico de pesquisa: É muito específico ou não é suficientemente claro? -2) **Se a etapa dois não produzir resultados:** Clique em "encontrar mais" (se disponível) para analisar mais dados. Se isso também não produzir nenhum resultado, você pode querer iniciar uma nova pesquisa com um prompt mais aberto, inclusive (por exemplo, "open search"). +1) **Se o passo 1 não retornar quaisquer dados potencialmente relevantes:** Lembre-se que, por padrão, a pesquisa de código apenas extrai novos dados. Se você já codificou completamente seus documentos, pode simplesmente não haver nada novo para explorar em um determinado tópico. Além disso, pense sobre sua pesquisa, especialmente o nome do código ou tópico de pesquisa: É muito específico ou não é suficientemente claro? +2) **Se a etapa dois não produzir resultados:** Clique em "encontrar mais" (se disponível) para analisar mais dados. Se isso também não produzir nenhum resultado, você pode querer iniciar uma nova pesquisa com um _prompt_ mais aberto, inclusive (por exemplo, "pesquisa aberta"). -Em geral, obter resultados não, muito poucos, ou principalmente irrelevantes é uma forte indicação de que um determinado tópico não é muito proeminente em seus dados. No entanto, não podemos garantir que a IA irá encontrar cada pedaço de dados relacionados ao seu código ou pesquisa gratuita sem perder nada. \ No newline at end of file +Em geral, obter nenhum, muito poucos, ou principalmente resultados irrelevantes é uma forte indicação de que um determinado tópico não é muito proeminente em seus dados. No entanto, não podemos garantir que a IA irá encontrar cada pedaço de dados relacionados ao seu código ou pesquisa livre sem perder nada. \ No newline at end of file diff --git a/docs/doc/pt/4.3.-Coding-Text-on-PDFs.md b/docs/doc/pt/4.3.-Coding-Text-on-PDFs.md index 7c0f26be..51a4c252 100644 --- a/docs/doc/pt/4.3.-Coding-Text-on-PDFs.md +++ b/docs/doc/pt/4.3.-Coding-Text-on-PDFs.md @@ -9,46 +9,46 @@ As áreas de texto e imagem no PDF podem ser codificadas. ![imagem](/images/ba02d9ee-24fe-4b67-84b0-4f62cd62a1c6.png) -### Prensas de teclas {#key-presses} - -* H Mostrar ou esconder as seções superiores da tela. -* Ctrl F salta para a caixa de pesquisa de texto. -* Ctrl Z desfaz o último código não marcado. -* Ctrl 1 Ir para o ficheiro seguinte. -* Ctrl 2 Ir para o último ficheiro codificado. -* Ctrl 4 Ver e editar o memorando do ficheiro. -* Ctrl 5 Obter a lista de arquivos dos atributos. -* Ctrl 9 Mostrar segmentos codificados importantes. Liga e desliga. -* Ctrl 0 Mostrar página de ajuda no navegador. +### Atalhos de teclas {#key-presses} + +* H Mostrar ou ocultar as seções superiores da tela. +* Ctrl + F leva o cursor à caixa de pesquisa de texto. +* Ctrl + Z desfaz o último código não marcado. +* Ctrl + 1 Ir para o arquivo seguinte. +* Ctrl + 2 Ir para o último arquivo codificado. +* Ctrl + 4 Ver e editar o memorando do arquivo. +* Ctrl + 5 Obter a lista de arquivos dos atributos. +* Ctrl + 9 Mostrar segmentos codificados importantes. Liga/desliga. +* Ctrl + 0 Mostrar página de ajuda no navegador. #### Na área de exibição PDF: {#in-the-pdf-display-area} -Você pode ampliar dentro e fora clicando no PDF mostrado e pressionando as teclas + ou -. -Pressione Q para marcar rapidamente a seleção com o código recente. +Você pode aumentar ou diminuir o zoom clicando no PDF mostrado e pressionando as teclas + ou -. +Pressione Q para marcar rapidamente a seleção com o código mais recente. Pressione R para marcar rapidamente a seleção com uma escolha de códigos usados recentemente. #### Na área de texto simples: {#in-the-plain-text-area} -* Um anotado - para a seleção atual - apenas edição de texto -* Q Quick Mark com código - para a seleção atual -* Eu Tag importante -* M memo code - na posição clicada -* O Atalho para ciclo através de códigos sobrepostos - na posição clicada +* A Anotação - para a seleção atual - apenas edição de texto +* Q Marcação rápida com código - para a seleção atual +* I Marcar como importante +* M Codificar memorando - na posição clicada +* O Atalho para iterar através de códigos sobrepostos - na posição clicada * R abre um menu de contexto para códigos usados recentemente para marcar texto * U Desmarcar na localização selecionada -* V atribuir código 'in vivo' ao texto selecionado +* V atribuir código '_in vivo_' ao texto selecionado -## Relatórios de exportação {#export-reports} +## Exportar Relatórios {#export-reports} Exportar em formato odt - compatível com LibreOffice e Microsoft Word. Ou como um PDF com destaque aplicado. -## Versões mais antigas 3.8.2 e anteriores {#older-versions-382-and-earlier} +## Versões mais antigas (3.8.2 e anteriores){#older-versions-382-and-earlier} -A tela é dividida em 3 painéis ajustáveis. O painel do lado esquerdo contém a lista de ficheiros e a árvore de códigos. O painel médio mostra a representação em PDF. O painel direito mostra o texto simples extraído do PDF. As fontes originais para o texto não são usadas. Em vez disso, a fonte padrão dentro do QualCoder é usada nas caixas de texto PDF exibidas. Existe um ajuste de tamanho de fonte para diminuir o tamanho da fonte, para tentar evitar sobreposição de texto. É definido em -2, e -3 pode ser muito bom também. +A tela é dividida em 3 painéis ajustáveis. O painel do lado esquerdo contém a lista de arquivos e a árvore de códigos. O painel médio mostra a representação em PDF. O painel direito mostra o texto simples extraído do PDF. As fontes originais para o texto não são usadas. Em vez disso, a fonte padrão dentro do QualCoder é usada nas caixas de texto PDF exibidas. Existe um ajuste de tamanho de fonte para diminuir o tamanho da fonte, para tentar evitar sobreposição de texto. É definido em -2; e -3 pode ser muito bom também. -O painel do lado direito mostra o texto simples da mesma forma que o texto seria exibido no texto Código. Você pode marcar, desmarcar, memo o texto codificado, marcar o código como importante e anotar o texto aqui. +O painel do lado direito mostra o texto simples da mesma forma que o texto seria exibido em Codificar Texto. Você pode marcar, desmarcar, ou gerar um memorando (a)o texto codificado, marcar o código como importante e criar anitações de texto aqui. -Para codificar, clique com o botão esquerdo e arraste o mouse para selecionar caixas de texto PDF. Isso pode ser complicado dependendo do tamanho e das posições das caixas. Em seguida, clique em um código para atribuir a seleção a ele. Outros ajustes podem ser feitos no painel de texto simples à direita usando as setas esquerda ou direita para estender, ou as setas alt esquerda e direita para encolher a seção de texto codificada. +Para codificar, clique com o botão esquerdo e arraste o mouse para selecionar caixas de texto PDF. Isso pode ser complicado dependendo do tamanho e das posições das caixas. Em seguida, clique em um código para atribuir a seleção a ele. Outros ajustes podem ser feitos no painel de texto simples à direita usando Shift + setas esquerda ou direita para estender, ou Alt + setas esquerda e direita para encolher o trecho de texto codificada. ## Categorias e códigos {#categories-and-codes} -Ver [Categorias e códigos](4.7.-Codes-Tree/) \ No newline at end of file +Veja [Categorias e códigos](4.7.-Codes-Tree/) \ No newline at end of file diff --git a/docs/doc/pt/4.4.-Coding-Images.md b/docs/doc/pt/4.4.-Coding-Images.md index 4d4c537f..0e052638 100644 --- a/docs/doc/pt/4.4.-Coding-Images.md +++ b/docs/doc/pt/4.4.-Coding-Images.md @@ -2,58 +2,56 @@ path: 4.4.-Coding-Images --- -# Codificação de imagens +# Codificar imagens -As imagens podem ser codificadas de forma semelhante à codificação de texto. Selecione um código. Clique com o botão esquerdo e arraste para destacar a área que deseja atribuir ao código. Botão direito do mouse abrirá um menu onde você pode remover o código ou adicionar um memorando. Na parte inferior da tela, existe um controle deslizante para redimensionar a imagem. Os retângulos codificados são coloridos para corresponder à cor do código. Clique com o botão direito da imagem para abrir as opções de rotação. +As imagens podem ser codificadas de forma semelhante à codificação de texto. Selecione um código. Clique com o botão esquerdo e arraste para destacar a área que deseja atribuir ao código. O Botão direito do _mouse_ abrirá um menu em que você pode remover o código ou adicionar um memorando. Na parte inferior da tela, existe um controle deslizante para redimensionar a imagem. Os retângulos codificados são coloridos para corresponder à cor do código. Clique com o botão direito na imagem para abrir as opções de rotação. -A parte superior direita do diálogo mostra alguns detalhes de um clique na área codificada - mostrando o nome de código, as posições de pixel e a área percentual de toda a imagem. Passando o mouse sobre este espaço irá mostrar qualquer memorando para a área codificada. +A parte superior direita do diálogo mostra alguns detalhes de uma área codificada que foi clicada - mostrando o nome do código, as posições de pixel e a área percentual de toda a imagem. Passando o _mouse_ sobre esse espaço irá mostrar qualquer memorando para a área codificada. -![imagem](/images/8e9e2ac8-61c0-4b4a-9d8b-31556da21fb2.png) +![image](/images/8e9e2ac8-61c0-4b4a-9d8b-31556da21fb2.png) -## Codificação de imagens PDF {#pdf-image-coding} +## Codificação de imagens de PDFs {#pdf-image-coding} -Os PDFs podem ser codificados aqui ou na seção Código PDF. +Os PDFs podem ser codificados aqui ou na seção Codificar PDF. -![imagem](/images/0522c7c4-0c5d-47f3-a0fb-6a752d9bf2e4.png) +![image](/images/0522c7c4-0c5d-47f3-a0fb-6a752d9bf2e4.png) -Botões de navegação em PDF: +Botões de navegação no PDF: ![Botões de navegação PDF](/images/36effc9c-f0a2-4f02-9fe0-293abcd3060a.png) ## Áreas codificadas importantes {#important-coded-areas} -Áreas importantes codificadas, como exemplos para um relatório, podem ser sinalizadas como Importante usando o menu com o botão direito do mouse quando nas áreas codificadas e selecionando Importante. No topo da tela está um botão com um símbolo de estrela. Este botão alterna entre mostrar todas as áreas codificadas e as áreas codificadas marcadas como Importantes. +Áreas codificadas importantes, como exemplos para um relatório, podem ser sinalizadas como Importante usando o menu com o botão direito do _mouse_ quando nas áreas codificadas e selecionando Importante. No topo da tela está um botão com um símbolo de estrela. Este botão alterna entre mostrar todas as áreas codificadas e as áreas codificadas marcadas como Importantes. ## Atalhos {#shortcuts} -* Atalho H. Pressione h quando na imagem para esconder e desocultar a seção de controles superiores da tela. +* Atalho H. Pressione h quando na imagem para ocultar e mostrar a seção de controles superiores da tela. * Atalho L. Pressione L para 'Mostrar códigos como', para mostrar uma lista na árvore de códigos. -* Pressione + ou - botões para ampliar ou encolher a imagem. -* Ctrl Z para restaurar a última área de codificação não marcada. +* Pressione + ou - para aumentar ou diminuir o _zoom_ da imagem. +* Ctrl+Z restaura a última área de codificação não marcada. ## Botões de conveniência abaixo da lista de arquivos {#convenience-buttons-underneath-the-files-list} -* Carregar o próximo ficheiro -* Carregar o ficheiro com a última codificação -* Abre o memorando do ficheiro seleccionado -* Use uma função de filtro mostrar apenas os arquivos que atendem a determinados critérios. Estes podem ser de atributos de arquivo ou se os arquivos estão associados a certos casos. (Botão que exibe uma etiqueta) +* Carregar o próximo arquivo +* Carregar o arquivo com a última codificação +* Abrir o memorando do arquivo selecionado +* Usar uma função de filtro para mostrar apenas os arquivos que atendem a determinados critérios. Estes podem ser de atributos de arquivo ou se os arquivos estão associados a certos casos. (Botão que exibe uma etiqueta) ## Clique com o botão direito na área da imagem para mais opções {#right-click-on-the-image-area-for-more-options} -As opções incluem rotação e destaque de um código específico ou área codificada. -Estas opções de realce são: acinzentado, borrado, solarizar, e eles abrem em seu programa de visualização de imagem padrão para visualizar e salvar. +As opções incluem rotação e destaque de um código específico ou área codificada. As opções de realce são: acinzentado, borrado, solarizar, e eles abrem em seu programa de visualização de imagem padrão para visualizar e salvar. -O botão legendas adicionará uma legenda a cada seção codificada escolhida: -Pressione uma vez para adicionar o nome de código. Pressione novamente para adicionar quaisquer memorandos. Pressione novamente para desligar as legendas. +O botão de legendas adicionará uma legenda a cada seção codificada escolhida: Clique-o uma vez para adicionar o nome do código. Clique-o novamente para adicionar quaisquer memorandos. Clique-o novamente para desligar as legendas. -Destaque o exemplo de áreas codificadas, com legendas: +Examplo de áreas codificadas destacadas e com legendas: ![imagem](/images/be991d7a-363b-4e5a-a93a-d02ccde42930.png) ## Exportação {#export} -A imagem com áreas codificadas pode ser exportada para um arquivo HTML. Depois de abrir o arquivo em um navegador, o mouse pairando sobre as áreas codificadas mostra o nome de código e memorandos. +A imagem com áreas codificadas pode ser exportada para um arquivo HTML. Depois de abrir o arquivo em um navegador, ao colocar o _mouse_ sobre as áreas codificadas mostra o nome do código e os memorandos. ## Categorias e códigos {#categories-and-codes} -Ver [Categorias e códigos](4.7.-Codes-Tree/) \ No newline at end of file +Veja [Categorias e códigos](4.7.-Codes-Tree/) \ No newline at end of file diff --git a/docs/doc/pt/4.5.-Coding-Audio-and-Video.md b/docs/doc/pt/4.5.-Coding-Audio-and-Video.md index 444693ed..70c195df 100644 --- a/docs/doc/pt/4.5.-Coding-Audio-and-Video.md +++ b/docs/doc/pt/4.5.-Coding-Audio-and-Video.md @@ -2,9 +2,9 @@ path: 4.5.-Coding-Audio-and-Video --- -# Codificação de áudio e vídeo +# Codificar áudio e vídeo -Ao codificar vídeo, duas telas são exibidas, como mostrado abaixo. Uma tela tem o vídeo reproduzindo. A outra tela principal tem os controles e um botão para iniciar e terminar um segmento codificado. A janela de controles mostra os códigos no painel inferior esquerdo e o texto do arquivo .transcribed é mostrado no painel inferior direito. Ao codificar áudio, somente a tela principal é mostrada. +Ao codificar vídeo, duas telas são exibidas, como mostrado abaixo. Uma tela contem o vídeo que esta sendo reproduzido. A outra tela principal tem os controles e um botão para iniciar e terminar um trecho codificado. A janela de controles mostra os códigos no painel inferior esquerdo e o texto do arquivo `.transcribed` é mostrado no painel inferior direito. Ao codificar áudio, somente a tela principal é mostrada. O texto de transcrição também pode ser codificado e anotado nesta janela. Clicar com o botão direito do mouse em uma hora na transcrição lhe dará uma opção de menu para ir para essa seção do vídeo. Se um vídeo tem várias faixas de áudio, você pode alterar a faixa de áudio também. Verificando a caixa de seleção rolagem permite que a transcrição role no tempo com o vídeo, com base em datas detectadas; no entanto, você precisa desmarcar a rolagem para ser capaz de codificar a transcrição. @@ -12,65 +12,65 @@ O texto de transcrição também pode ser codificado e anotado nesta janela. Cli ## Atalhos de teclado {#keyboard-shortcuts} -* Ctrl R Rebobinar 5 segundos -* Alt R ou Alt Minus Rebobinar 30 segundos -* Alt F ou Alt Plus Avançar 30 segundos -* Ctrl P ou Ctrl D irá parar/iniciar (play/pause). Ao retomar o áudio/vídeo rebobina um segundo. -* Ctrl S iniciará/fim A/V criação de segmento. -* Ctrl Shift < irá reduzir a taxa de reprodução para um mínimo de 0,1 -* Ctrl Shift > aumentará a taxa de reprodução até duas vezes. -* Ctrl Z Restaura o último código não marcado. +* Ctrl+R Rebobina 5 segundos +* Alt+R ou Alt+Menos Rebobina 30 segundos +* Alt+F ou Alt+Mais/Alt+Igual Avança 30 segundos +* Ctrl+P ou Ctrl+D para/inicia (_play_/_pause_). Ao retomar o áudio/vídeo rebobina um segundo. +* Ctrl+S iniciará/fim A/V criação de segmento. +* Ctrl+Shift+< reduz a velocidade da mídia até o mínimo de 0,1x (ou 10% da original) +* Ctrl+Shift+> aumenta velocidade da mídia até o até duas vezes (2x). +* Ctrl+Z Restaura o último código não marcado. -(Estas opções também estão disponíveis através dos ícones da barra de ferramentas.) +(Estas opções também estão disponíveis através dos ícones na barra de ferramentas) -Quando a área de texto tem foco: +Quando a área de texto está selecionada: * Pressione A para anotar o texto selecionado * Pressione L para 'Mostrar códigos como', para mostrar uma lista na árvore de códigos. -* Pressione M para memo um código. (Deve clicar sobre um segmento de texto codificado) -* Pressione O para ciclo através de códigos sobrepostos in situ. (Deve clicar sobre um segmento de códigos sobreposto - denotado com um overline). -* Pressione Q para código rápido com o código mais recente. (Deve ter uma seleção de texto) -* Pressione R para selecionar códigos recentes. (Deve ter uma seleção de texto) +* Pressione M para memorando de um código. (Deve clicar sobre um segmento de texto codificado) +* Pressione O para alternar pelos códigos sobrepostos _in situ_. (Deve clicar sobre um trecho com códigos sobrepostos - denotado com um _overline_). +* Pressione Q para codificação rápida, usando o código mais recente. (Deve ter um trecho de texto selecionado) +* Pressione R para selecionar códigos recentes. (Deve ter um trecho de texto selecionado) -## Segmentos de vídeo de áudio {#audio-video-segments} +## Segmentos de vídeo e de áudio {#audio-video-segments} -Uma vez que um segmento é feito usando o botão Start segment/Stop segment , isso pode ser atribuído a um código clicando com o botão direito do mouse no código relevante e atribuindo o segmento. +Uma vez que um segmento é criado usando o botão Iniciar segmento/Parar segmento, ele pode ser atribuído a um código clicando com o botão direito do _mouse_ no código relevante e atribuindo o segmento. -Faixas de codificação para os segmentos codificados são mostradas na área inferior. Passando o mouse sobre cada faixa mostra o nome de código, segmento de tempo, e qualquer memorando anexado a esse segmento codificado. Clicar com o botão direito em uma faixa de segmento codificada mostra um menu que pode ser usado para editar o memorando, marcar como um segmento importante ou excluir o segmento codificado. +Faixas de codificação para os segmentos codificados são mostradas na área inferior. Passar o mouse sobre cada faixa mostra o nome de código, tempo do segmento, e qualquer memorando anexado a esse segmento codificado. Clicar com o botão direito em uma faixa de segmento codificado mostra um menu que pode ser usado para editar o memorando, marcar como um segmento importante ou excluir o segmento codificado. -O texto transcrito também pode ser codificado e anotado nesta janela. No entanto, quando a caixa de verificação de transcrição do Scroll é marcada, isso não pode ser realizado. Reproduzir o vídeo quando este estiver marcado irá rolar a transcrição usando as datas com o vídeo. +O texto transcrito também pode ser codificado e anotado nesta janela. No entanto, quando a caixa de verificação de rolar transcrição é marcada, isso não pode ser realizado. Reproduzir o vídeo quando este estiver marcado irá rolar a transcrição usando as marcações de tempo sincornizadas com o vídeo. -## Texto e segmentos codificados importantes {#important-coded-text-and-segments} +## Texto e segmentos codificados como importantes {#important-coded-text-and-segments} -Textos codificados importantes, como exemplos para um relatório, podem ser sinalizados Importante usando o menu com o botão direito do mouse quando no texto codificado e selecionando Importante. Da mesma forma, segmentos de código podem ser sinalizados Importante. No topo da tela está um botão com um símbolo de estrela. Isto alterna entre mostrar todos os textos codificados e segmentos ou texto e segmentos importantes codificados. +Textos codificados importantes, como exemplos para um relatório, podem ser sinalizados como Importante usando o menu com o botão direito do _mouse_ quando no texto codificado e selecionando Importante. Da mesma forma, trechos de código podem ser sinalizados Importante. No topo da tela está um botão com um símbolo de estrela. Isto alterna entre mostrar todos os trechos de texto codificados e trechos de texto codificadados marcados como importantes. -**Ligar texto para segmentos codificados ** +**Ligando texto a segmentos codificados** -Selecione o texto (pode ser codificado ou preferencialmente não codificado), então atribua-o a um segmento. Primeiro, selecione o texto. Em seguida, clique com o botão direito na faixa de segmento para abrir o menu. Escolha o texto Link para o segmento, para atribuir o texto. +Selecione o texto (pode ser codificado ou preferencialmente não codificado), então atribua-o a um segmento. Primeiro, selecione o texto. Em seguida, clique com o botão direito na faixa de segmento para abrir o menu. Escolha o Vincular texto ao segmento, para atribuir o texto. ## Modificar as posições do código na área de texto {#modifying-code-positions-in-the-text-area} -Quando na área de texto, clique em um código com o mouse (Nota: o código não deve se sobrepor com outro código nessa posição). Pressione as seguintes combinações de teclas para estender ou encolher o segmento de texto codificado. +Quando na área de texto, clique em um código com o _mouse_ (Nota: o código não deve se sobrepor a outro código nessa mesma posição). Pressione as seguintes combinações de teclas para estender ou encolher o segmento de texto codificado. -* Shift + seta esquerda Extende o texto codificado para a esquerda -* Shift + seta direita Extende o texto codificado para a direita -* Alt + seta esquerda encolhe texto codificado do lado direito para a esquerda -* Alt + seta direita encolhe texto codificado do lado esquerdo para a direita +* Shift+seta esquerda: Extende o texto codificado para a esquerda +* Shift+seta direita: Extende o texto codificado para a direita +* Alt+seta esquerda: Encolhe o texto codificado do lado direito para a esquerda +* Alt+seta direita: Encolhe o texto codificado do lado esquerdo para a direita -Você também pode clicar com o botão direito em um código e selecionar mudar a posição inicial ou mudar a posição final usando os punhos. +Você também pode clicar com o botão direito em um código e selecionar mudar a posição inicial ou mudar a posição final usando as seleções deslizáveis. -Você também pode exportar uma captura de tela. A imagem será salva como Frame yyymmdd hh mm ss.jpg. Você pode salvar uma imagem para codificação de imagem dentro do projeto. +Você também pode exportar uma captura de tela. A imagem será salva como `Frame_yyyymmdd_hh_mm_ss.jpg`. Você pode salvar essa imagem para codificação de imagem dentro do projeto. ## Botões de conveniência abaixo da lista de arquivos {#convenience-buttons-underneath-the-files-list} -* Carregar o próximo ficheiro -* Carregar o ficheiro com a última codificação -* Abre o memorando do ficheiro seleccionado -* Use uma função de filtro mostrar apenas os arquivos que atendem a determinados critérios. Estes podem ser de atributos de arquivo ou se os arquivos estão associados a certos casos. +* Carregar o próximo arquivo +* Carregar o arquivo com a última codificação +* Abrir o memorando do arquivo selecionado +* Usar uma função de filtro para mostrar apenas os arquivos que atendem a determinados critérios. Estes podem ser de atributos de arquivo ou se os arquivos estão associados a certos casos. ## Problemas de áudio e vídeo em alguns sistemas operacionais {#audio-and-video-problems-on-some-operating-systems} -Fedora não funciona com o áudio e vídeo. +O Fedora não funciona com o áudio e vídeo. ## Categorias e códigos {#categories-and-codes} diff --git a/docs/doc/pt/4.6.-Code-Organiser.md b/docs/doc/pt/4.6.-Code-Organiser.md index 6832f7d7..63bbaf1d 100644 --- a/docs/doc/pt/4.6.-Code-Organiser.md +++ b/docs/doc/pt/4.6.-Code-Organiser.md @@ -2,15 +2,15 @@ path: 4.6-Code-Organiser --- -# Organizador de Código +# Organizador de Códigos -O organizador de código permite alterar a estrutura da árvore de codificação. +O organizador de códigos permite alterar a estrutura da árvore de codificação. -Quando você abrir pela primeira vez, você será solicitado a fazer backup do seu projeto antes de fazer ou aplicar quaisquer alterações. As alterações feitas aqui não podem ser desfeitas. +Quando você abrí-lo pela primeira vez, você será solicitado a fazer _backup_ do seu projeto antes de fazer ou aplicar quaisquer alterações. As alterações feitas aqui não podem ser desfeitas. ![imagem](/images/ae81b366-54e8-457f-9afe-abb7f76d2a41.png) -Usando o botão mais à esquerda, selecione todos os branches de código em seu projeto, ou apenas um branch de código específico. +Usando o botão mais à esquerda, selecione todos os ramos de códigos em seu projeto, ou apenas um ramos de códigos específico. ![imagem](/images/57b82319-1145-4872-a6c7-63cbc807b370.png) @@ -20,13 +20,13 @@ Todas as subcategorias e códigos da sua seleção serão exibidos. **Códigos:** -Clique com o botão direito do mouse em um código para obter opções de: Removendo da categoria, movendo-se para outra categoria, mesclando em outro código, visualizar/editar o memorando, renomeando, visualizando a mídia codificada, exibindo o memorando sob o nome de código. +Clique com o botão direito do _mouse_ em um código para obter opções: remover da categoria, mover para outra categoria, Mesclar em outro código, Visualizar/editar o memorando, renomear, visualizar a mídia codificada, exibir o memorando sob o nome do código. **Categorias:** Existe um botão no topo da tela para adicionar uma nova categoria. -Clique com o botão direito em uma categoria para: mesclar uma categoria em outra categoria, mover uma categoria em outra categoria, remover uma categoria de sob outra categoria, renomear uma categoria, visualizar e editar memorando, ou apenas exibir o memorando sob o nome da categoria. +Clique com o botão direito em uma categoria para: mesclar uma categoria em outra categoria, mover uma categoria para outra categoria, remover uma categoria sob outra categoria, renomear uma categoria, visualizar e editar memorando, ou apenas exibir o memorando sob o nome da categoria. Mostrando o memorando sob o nome da categoria @@ -34,4 +34,4 @@ Mostrando o memorando sob o nome da categoria Existe um botão para exportar a imagem como um arquivo PNG. -O botão Aplicar faz as alterações na estrutura da árvore de codificação. Se não pressionado, as mudanças não são promulgadas. \ No newline at end of file +O botão Aplicar faz as alterações na estrutura da árvore de codificação. Se não pressionado, as mudanças não ocorrem de fato. \ No newline at end of file diff --git a/docs/doc/pt/4.7.-Codes-Tree.md b/docs/doc/pt/4.7.-Codes-Tree.md index 5bd39b17..4c3ad535 100644 --- a/docs/doc/pt/4.7.-Codes-Tree.md +++ b/docs/doc/pt/4.7.-Codes-Tree.md @@ -4,20 +4,20 @@ path: 4.7.-Codes-Tree # Categorias e códigos -As categorias são utilizadas para organizar códigos. As categorias são organizadas hierarquicamente em uma estrutura de árvore. Você pode mover códigos para categorias e mover categorias para categorias maiores. Você pode mover categorias e códigos para fora de sua posição atual. Um código pode ter sub-códigos (novo na versão 4.0). Códigos e categorias podem ser mesclados através da introdução de um código em um código ou categoria em uma categoria. Clique com o botão direito em uma categoria ou código para renomear. Carregue com o botão direito num código para alterar a cor. +As categorias são utilizadas para organizar códigos. As categorias são organizadas hierarquicamente em uma estrutura de árvore. Você pode mover códigos para categorias e mover categorias para categorias maiores. Você pode mover categorias e códigos para fora de sua posição atual. Um código pode ter sub-códigos (novidade da versão 4.0). Códigos e categorias podem ser mesclados através da introdução de um código em um código ou categoria em uma categoria. Clique com o botão direito em uma categoria ou código para renomear. Clique com o botão direito num código para alterar a cor. -Categorias e códigos podem ser atribuídos memorandos. Os memorandos podem conter símbolos como aqueles [mostrado aqui](https://www.alt-codes.net//). Veja o link how-to para inseri-los - Laptop num lock on, segure a tecla Alt para baixo e digite o número usando o teclado número à direita. +Categorias e códigos podem ser atribuídos memorandos. Os memorandos podem conter símbolos como os [mostrados aqui](https://www.alt-codes.net//). Veja o tutorial para inseri-los - Laptop com o Num Lock ligado, segure a tecla Alt para baixo e digite o número usando o teclado número à direita. !!! note - A capacidade de atribuir um único código a várias categorias é uma característica frequentemente solicitada. No entanto, decidimos não implementar essa funcionalidade, pois seria excessivamente complicado. Isso é devido ao uso da estrutura de uma árvore pela QualCoder, enquanto o recurso solicitado requer [estrutura de dados do gráfico](https://www.baeldung.com/cs/tree-vs-graph-data-structure)Como alternativa, você pode usar códigos com nomes semelhantes em suas diferentes categorias. + A capacidade de atribuir um único código a várias categorias é uma característica frequentemente solicitada. No entanto, decidimos não implementar essa funcionalidade, pois seria excessivamente complicado. Isso é devido ao uso da estrutura de uma árvore pelo QualCoder, enquanto o recurso solicitado requer [estrutura de dados do gráfico](https://www.baeldung.com/cs/tree-vs-graph-data-structure). Como alternativa, você pode usar códigos com nomes semelhantes em suas diferentes categorias. ## Redução da quantidade de códigos exibidos na árvore de códigos {#reducing-the-amount-of-codes-displayed-in-the-codes-tree} -Para reduzir o número de códigos mostrados na árvore de código. Nas janelas de codificação (texto de código, código, a/v ou imagem de código), clique com o botão direito na árvore de código e selecione Mostrar códigos como no menu, ou quando a árvore de códigos está em foco pressione F9.. Em seguida, digite texto na caixa de texto. Isto só mostrará códigos que contenham esse texto. Para mostrar todos os códigos novamente, digite nada na caixa de texto e pressione OK para mostrar todos os códigos. +Para reduzir o número de códigos mostrados na árvore de códigos. Nas janelas de codificação (codificar, codificar, a/v ou codificar imagem), clique com o botão direito na árvore de códigos e selecione _Mostrar códigos como_ no menu, ou quando a árvore de códigos está focada pressione F9. Em seguida, digite texto na caixa de texto. Isto só mostrará códigos que contenham esse texto. Para mostrar todos os códigos novamente, basta digitar nada (ou apagar o texto inserido) na caixa de texto e pressione OK para mostrar todos os códigos. -Uma segunda opção é Mostrar códigos de cor . Pressione a tecla F10 quando a árvore de códigos está em foco. +Uma segunda opção é Mostrar códigos coloridos . Pressione a tecla F10 quando a árvore de códigos está focada. -Outro botão sob a árvore de códigos - com um ícone de pesquisa - ao clicar irá procurar o primeiro código que contém o texto correspondente que você inserir. +Outro botão sob a árvore de códigos - com um ícone de pesquisa - irá procurar, ao clicá-lo, o primeiro código que contém o texto correspondente que você inserir. ## Opções do menu da árvore de códigos {#codes-tree-menu-options} @@ -27,16 +27,16 @@ Na árvore de códigos à esquerda, clicando com o botão direito em um código ### Mostrar os ficheiros codificados {#show-coded-files} -Uma opção é Mostrar arquivos codificados - isso mostra em qualquer lugar que você tenha codificado com o código selecionado. Clicando em uma seção codificada em particular irá abrir esse código no contexto original para mais informações. +Uma opção é Mostrar arquivos codificados - isso mostra todos os lugares em que você tenha codificado com o código selecionado. Clicando em uma seção codificada em particular irá abrir esse código no contexto original para mais informações. -Com arquivos codificados show, você pode clicar com o botão direito na seção de cabeçalho colorido para mais opções, tais como adicionar mais códigos, remover o código e exportar todo o conjunto de segmentos codificados para um arquivo de texto. +Com Mostrar arquivos codificados, você pode clicar com o botão direito na seção de cabeçalho colorido para mais opções, tais como adicionar mais códigos, remover o código e exportar todo o conjunto de segmentos codificados para um arquivo de texto. ![imagem](/images/7f0d079d-c0a8-4966-87bd-a6723f541d8d.png) -Ordenar a árvore de códigos em ascensão (chave F11 quando códigos em foco), ou descendente (chave F12 quando árvore em foco). +Ordene a árvore de códigos de modo ascendente (tecla F11 quando a árvore de códigos está focada), ou descendente (tecla F12 quando a árvore de códigos está focada). ## Acessibilidade e cores de código {#accessibility-and-code-colours} -No menu de codificação existe uma opção chamada ** esquema de cores**. +No menu de codificação existe uma opção chamada **paleta de cores**. -Você pode aplicar uma gama de cores a uma gama de códigos selecionados, em vez de confiar nas cores geradas aleatoriamente ou uma de cada vez mudança de cores para cada código. Nesta área você também pode ver como as cores do código podem aparecer para alguém que tem uma variedade de cegueira de cor: vermelho-fraco, vermelho-cego, verde-fraco ou verde-cego. \ No newline at end of file +Você pode aplicar uma gama de cores a uma gama de códigos selecionados, em vez de confiar nas cores geradas aleatoriamente ou mudar uma cor de cada vez para cada código. Nesta área você também pode ver como as cores dos códigos podem aparecer para alguém que possui diferentes tipos de daltonismo: vermelho-fraco, cego ao vermelho-cego, verde-fraco ou cego ao verde. \ No newline at end of file diff --git a/docs/doc/pt/5.1.-AI-chat-based-analysis.md b/docs/doc/pt/5.1.-AI-chat-based-analysis.md index 78ede96a..eb7c904f 100644 --- a/docs/doc/pt/5.1.-AI-chat-based-analysis.md +++ b/docs/doc/pt/5.1.-AI-chat-based-analysis.md @@ -8,113 +8,113 @@ path: 5.1.-AI-chat-based-analysis **1) Escolha dos modelos de IA** -O agente de IA em QualCoder não está ligado a um modelo específico. Você decide qual modelo de linguagem de IA usar, seja um dos grandes modelos comerciais, um modelo de médio porte em uma plataforma acadêmica de IA, ou um modelo de linguagem local em seu próprio computador. Para mais informações, consultar [Configuração do IA](./2.3.-AI-Setup.md). +O agente de IA do QualCoder não está ligado a um modelo específico. Você decide qual modelo de linguagem de IA usar, seja um dos grandes modelos comerciais, um modelo de médio porte em uma plataforma acadêmica de IA, ou um modelo de linguagem local em seu próprio computador. Para mais informações, consulte a [Configuração da IA](./2.3.-AI-Setup.md). -**2) Flexibilidade metodológica +**2) Flexibilidade metodológica** -O agente de IA em QualCoder não define um método próprio. Em vez disso, fornece uma plataforma metodologicamente flexível para a experimentação. Sua pergunta de pesquisa, os insights que você procura, e sua abordagem metodológica definir a direção. Uma vez que uma abordagem provou ser útil, você pode salvá-lo e reutilizá-lo mais tarde (ver [Biblioteca AI Prompt](./6.3.-AI-Prompt-Library.md)). +O agente de IA do QualCoder não define um método próprio. Em vez disso, fornece uma plataforma metodologicamente flexível para a experimentação. Sua pergunta de pesquisa, os _insights_ que você procura, e sua abordagem metodológica definem a direção. Uma vez que uma abordagem provou ser útil, você pode salvá-la e reutilizá-la mais tarde (veja [Biblioteca de Prompts de IA](./6.3.-AI-Prompt-Library.md)). -**3) Transparência ** +**3) Transparência** -Os impulsos que orientam o trabalho do agente de IA são acessíveis e podem, em princípio, ser adaptados. Durante o trabalho, o agente também mantém você informado sobre suas etapas e fornece referências de fonte detalhadas. Isso permite que você veja quais dados ele baseia e examinar passagens em seu contexto original. +Os _prompts_ que orientam o trabalho do agente de IA são acessíveis e podem, em princípio, ser adaptados. Durante o trabalho, o agente também mantém você informado sobre suas etapas e fornece referências de fonte detalhadas. Isso permite que você veja em quais dados ele se baseia e examine passagens em seu contexto original. **4) Colaboração em vez de automação** -O foco é trabalhar com IA através do diálogo: desenvolver perspectivas adicionais, questionar suas próprias interpretações e obter uma melhor compreensão do material. A pedido, o agente também pode realizar tarefas mais longas de forma semi-autônoma. A automação em grande escala, no entanto, nunca foi o objetivo principal. +O foco é trabalhar com a IA através do diálogo: desenvolver perspectivas adicionais, questionar suas próprias interpretações e obter uma melhor compreensão do material. Quando solicitado, o agente também pode realizar tarefas mais longas de forma semi-autônomo. A automação em grande escala, no entanto, nunca foi o objetivo principal. -## Trabalhar com o agente de IA {#working-with-the-ai-agent} +## Trabalhando com o agente de IA {#working-with-the-ai-agent} -- O agente de IA tem sua **separação ** em QualCoder. Você também pode movê-lo para uma barra lateral** (veja abaixo), ao lado de seus dados, clicando no botão seta pequena. -![Botão de seta para mover o agente de IA para a barra lateral](../../images/ai-agent-sidebar-button-de.png){ largura="118"} +- O agente de IA tem sua própria **aba** no QualCoder. Você também pode movê-lo para uma **barra lateral** (veja abaixo), ao lado de seus dados, clicando na seta pequena. +![Botão de seta para mover o agente de IA para a barra lateral](../../images/ai-agent-sidebar-button-de.png){ width="118"} - Na janela de chat, descreva em suas próprias palavras o que você gostaria de investigar ou trabalhar. -![A janela de chat do agente de IA no QualCoder](../../images/ai-agent-chat-de.png){largura="600"} +![A janela de chat do agente de IA no QualCoder](../../images/ai-agent-chat-de.png){width="600"} !!! note - O IA deve estar ** totalmente carregado** e pronto para novas consultas antes de iniciar um chat (barra de status: "AI: pronto"). + A IA deve estar **totalmente carregada** e pronta para novas consultas antes de iniciar um chat (barra de _status_: "IA: pronta"). ### Para que serve o agente de IA? {#what-is-the-ai-agent-for} -- O agente de IA ajuda você **explore seu material empírico,** desenvolva interpretações e análises, dados de código e escreva memorandos. -- Você pode discutir passagens individuais com a IA ou pesquisar todo o corpus do projeto para temas ou casos contrastantes. -- Você pode desenvolver seu sistema de código, ideias de brainstorm e estratégias analíticas, e confira-os diretamente com os dados empíricos. -- Ao contrário dos chatbots genéricos, o agente de IA em QualCoder ** capta exatamente onde sua análise parou:** examina o sistema de código atual, pode ler memorandos e passagens codificadas, incorporar casos e suas características (atributos) na análise, e muito mais. Isso lhe dá feedback adaptado à fase atual de sua pesquisa. +- O agente de IA ajuda você a **explorar seu material empírico**, desenvolva interpretações e análises, dados de código e escreva memorandos. +- Você pode discutir passagens individuais com a IA ou pesquisar todo o _corpus_ do projeto para temas ou casos contrastantes. +- Você pode desenvolver seu sistema de código, ideias de _brainstorm_ e estratégias analíticas, e conferí-los diretamente com os dados empíricos. +- Ao contrário dos _chatbots_ genéricos, o agente de IA do QualCoder **continua exatamente onde sua análise parou:** ele examina o sistema de código atual, pode ler memorandos e passagens codificadas, incorporar casos e suas características (atributos) na análise, e muito mais. Isso lhe dá _feedback_ adaptado à fase atual de sua pesquisa. ### O que pode o agente de IA fazer? {#what-can-the-ai-agent-do} -- Mesmo com apenas **read access** para o projeto, o agente de IA já é uma poderosa ferramenta de brainstorming. -- A pedido, pode também **avançar activamente a análise**. Com as permissões apropriadas (veja abaixo), ele pode criar novos códigos ou reorganizar os existentes, encontrar e codificar novas passagens de texto, revisar memorandos ou criar novos atributos de caso. -- Em conversa com o agente, você pode revisar sugestões, fazer perguntas de seguimento e decidir como proceder. +- Mesmo apenas com **acesso de leitura** ao projeto, o agente de IA já é uma poderosa ferramenta de _brainstorming_. +- Quando solicitado, pode também **avançar ativamente a análise**. Com as permissões apropriadas (veja abaixo), ele pode criar novos códigos ou reorganizar os existentes, encontrar e codificar novas passagens de texto, revisar memorandos ou criar novos atributos de caso. +- Em conversa com o agente, você pode revisar sugestões, fazer novas perguntas e decidir como proceder. ### Quais são as suas limitações? {#what-are-its-limitations} -- Atualmente, o agente de IA só pode trabalhar com ** dados de texto**, não com imagens, áudio ou vídeo. Os periódicos da QualCoder também estão excluídos por enquanto. +- Atualmente, o agente de IA só pode trabalhar com **dados de texto**, não com imagens, áudio ou vídeo. Os diários do QualCoder também estão excluídos por enquanto. - Você pode escolher entre três níveis de permissão: -Nível de permissão --------- -*Somente leitura** O agente de IA só tem acesso lido a códigos, memorandos e dados empíricos. -*Sandboxed** (default)**Limited write access: o agente pode criar seus próprios códigos e códigos, mas não pode modificar os existentes. -* Acesso completo** O agente pode fazer quase tudo que um usuário humano pode, incluindo fazer alterações no sistema de código, casos, memorandos e atributos. +Nível de permissão|Descrição +|---|---| +**Somente leitura**|O agente de IA só tem acesso de leitura a códigos, memorandos e dados empíricos. +**_Sandboxed_ ("isolado")** (padrão)|Acesso de escrita limitado: o agente pode criar seus próprios códigos e códigos, mas não pode modificar os existentes. +**Acesso completo**| O agente pode fazer quase tudo que um usuário humano pode, incluindo fazer alterações no sistema de código, casos, memorandos e atributos. -- Um **limite restrito** sempre se aplica: os documentos empíricos formam a "verdade de fundo" de toda a análise. Em nenhuma circunstância o IA pode modificá-los. -- O agente de IA também não tem ** acesso a informações externas,** como informações da internet. Portanto, ele só pode trabalhar com dados que você deliberadamente incluiu no projeto. +- Um **limite** sempre se aplica: os documentos empíricos formam a "verdade de fundo" de toda a análise. Em nenhuma circunstância a IA pode modificá-los. +- O agente de IA também não tem **acesso a informações externas**, como informações da internet. Portanto, ele só pode trabalhar com dados que você deliberadamente incluiu no projeto. ### Como posso ver que mudanças a IA faz? {#how-can-i-see-which-changes-the-ai-makes} -- O agente ** documenta seus passos no chat,** fornece referências de origem, e pergunta antes de fazer grandes mudanças. -- Você pode facilmente **undo** as últimas alterações do agente de IA usando o botão correspondente na janela de bate-papo: +- O agente **documenta seus passos no chat,** fornece referências às fontes, e pergunta antes de fazer grandes mudanças. +- Você pode facilmente **desfazer** as últimas alterações do agente de IA usando o botão correspondente na janela de bate-papo: - ![Botão para desfazer as últimas alterações do agente de IA](../../images/ai-agent-undo-de.png){largura="250"} + ![Botão para desfazer as últimas alterações do agente de IA](../../images/ai-agent-undo-de.png){width="250"} -- Todos os novos itens que o agente cria (códigos, códigos, etc.) são rotulados com o nome ** especial do codificador "AI Agent".** +- Todos os novos itens que o agente cria (códigos, códigos, etc.) são rotulados com o nome **especial do codificador "Agende de IA"**. - ![Itens criados pelo agente de IA com o nome do codificador AI Agent](../../images/ai-agent-coder-de.png){largura="600"} + ![Itens criados pelo agente de IA com o nome do codificador Agende de IA](../../images/ai-agent-coder-de.png){width="600"} -- Para mostrar ou ocultar** Códigos gerados por IA, clique nos três pontos ("...") no topo esquerdo da janela de codificação, próximo ao nome do codificador atual, e ajuste a visibilidade para "AI Agent". +- Para **mostrar ou ocultar** os Códigos gerados por IA, clique nos três pontos ("...") no topo esquerdo da janela de codificação, próximo ao nome do codificador atual, e ajuste a visibilidade para "Agende de IA". - ![Ajustar a visibilidade dos códigos do agente de IA](../../images/ai-agent-code-visibility-de.png){largura="250"} + ![Ajustar a visibilidade dos códigos do agente de IA](../../images/ai-agent-code-visibility-de.png){width="250"} ### Como devo preparar meu projeto? {#how-should-i-prepare-my-project} -- Um bom **project memo** é muito importante (menu: "Project > Project memo"). Deve conter: +- Um bom **memorando de projeto** é muito importante (menu: "Projeto > Memorando do Projeto"). Deve conter: - - A questão de investigação e os objectivos do projecto + - A questão de investigação e os objectivos do projeto - O tipo de material empírico (por exemplo, entrevistas narrativas) e a abordagem de amostragem - A abordagem metodológica da análise - - Quaisquer outros detalhes que o agente de IA deve ter em conta. + - Quaisquer outros detalhes que o agente de IA deve levar em consideração. O memorando do projeto é fornecido ao agente como informação de fundo para cada conversa. -- Além disso, **nomes de documentos** devem ser significativos (por exemplo, "Entrevista Alice"). -- Em ** transcrições de entrevista**, entrevistadores e entrevistados devem ser claramente identificados para que seus papéis sejam reconhecíveis mesmo em trechos curtos. -- Bom **code memos** também ajudar a IA entender o que você quer dizer. +- Além disso, os **nomes de documentos** devem ser significativos (por exemplo, "Entrevista Alice"). +- Em **transcrições de entrevista**, entrevistadores e entrevistados devem ser claramente identificados para que seus papéis sejam reconhecíveis mesmo em trechos curtos. +- Um bom **memorando de códigos** também ajuda a IA entender o que você quer dizer. !!! note - ** Verificar a prontidão do projeto IA:** Com este comando no menu "AI", o agente analisa automaticamente o projeto e sugere maneiras de melhorar sua legibilidade. + **Verificar a preparação do projeto para a IA:** Com este comando no menu "IA", o agente analisa automaticamente o projeto e sugere maneiras de melhorar sua legibilidade. !!! note - ** Notas pessoais em memorandos:** Se você também quiser usar memorandos para notas pessoais, escreva-os após o separador `#####`Tudo depois é inacessível para a IA. + **Notas pessoais em memorandos:** Se você também quiser usar memorandos para notas pessoais, escreva-os após o separador `#####`. Tudo depois dessa marca é inacessível para a IA. ### Como funciona o agente de IA? {#how-does-the-ai-agent-work} -- O agente de IA só age quando você lhe dá uma tarefa**, não por sua própria iniciativa. -- O agente trabalha através de uma tarefa em **ReAct loop** (Refletir + Acto, [Shunyu et al. 2022](https://arxiv.org/abs/2210.03629)): +- O agente de IA só age quando você lhe dá uma **tarefa**, não por sua própria iniciativa. +- O agente trabalha através de uma tarefa em um **ReAct _loop_** (Refletir + Agir, [Shunyu et al. 2022](https://arxiv.org/abs/2210.03629)): 1. Cria um plano para a realização da tarefa. 2. Realiza as ações planejadas (por exemplo, pesquisa de dados ou códigos de leitura). - 3. Analisa os resultados e decide se são necessárias mais acções (por exemplo, leitura de mais dados). Se assim for, retorna ao passo 2. + 3. Analisa os resultados e decide se são necessárias mais ações (por exemplo, leitura de mais dados). Se assim for, retorna ao passo 2. - Dependendo da complexidade da tarefa, este loop pode se repetir muitas vezes. Os passos individuais são mostrados em cinzento na janela de chat. + Dependendo da complexidade da tarefa, este _loop_ pode se repetir muitas vezes. Os passos individuais são mostrados em texto acinzentado na janela de _chat_. Uma vez que o resultado é satisfatório (por exemplo, dados suficientes foram encontrados), o agente formula uma resposta final e espera por mais instruções. -- O agente tem **powerful tools** à sua disposição: por exemplo, ele pode realizar uma pesquisa de similaridade semântica em todo o corpus, pesquisar usando expressões regulares ou um índice de palavras-chave BM25, e chamar ferramentas para criar ou modificar códigos se ele tiver permissões de escrita. +- O agente tem **ferramentas poderosas** à sua disposição: por exemplo, ele pode realizar uma pesquisa de similaridade semântica em todo o _corpus_, pesquisar usando expressões regulares ou um índice de palavras-chave BM25, e chamar ferramentas para criar ou modificar códigos se ele tiver permissões de escrita. ### O que acontece aos meus dados? {#what-happens-to-my-data} - Todos os dados são mantidos **localmente em seu computador** no projeto QualCoder atual. As operações de pesquisa mencionadas acima também são executadas localmente. - O modelo **AI só vê a parte dos dados** (por exemplo, resultados de busca ou passagens individuais) especificamente necessária para a análise atual. Esses fragmentos de dados são enviados para o modelo de IA juntamente com a tarefa relevante. -- Nas suas respostas, o agente de IA documenta em pormenor os dados em que as suas análises se baseiam. QualCoder transforma essas referências em **links de código com números de linha.** Clicar em uma referência abre a passagem em seu contexto original. +- Nas suas respostas, o agente de IA documenta em pormenor os dados em que as suas análises se baseiam. O QualCoder transforma essas referências em **_links_ de código com números de linha.** Clicar em uma referência abre a passagem em seu contexto original. ## Quatro maneiras de começar uma conversa com o agente {#four-ways-to-start-a-conversation-with-the-agent} @@ -122,7 +122,7 @@ Nível de permissão Na parte inferior esquerda da janela do agente de IA, você pode iniciar uma nova análise de uma das quatro maneiras: -![Menu para iniciar uma nova análise com o agente de IA](../../images/ai-agent-new-analysis-de.png){largura="250"} +![Menu para iniciar uma nova análise com o agente de IA](../../images/ai-agent-new-analysis-de.png){width="250"} Essas opções simplesmente fornecem **pontos de partida diferentes** para a análise. Você pode então levar a conversa em qualquer direção que você escolher, usando o conjunto de ferramentas completo disponível para o agente. @@ -130,93 +130,93 @@ Essas opções simplesmente fornecem **pontos de partida diferentes** para a an Esta é a maneira mais flexível de iniciar uma nova análise com o agente. Comece com uma ideia ou uma pergunta aberta, ou nomeie os códigos ou passagens que você gostaria de investigar. -**Exemplo: Encontrar casos comparáveis +**Exemplo: Encontrar casos comparáveis** -> *"A partir da linha 127, Sarah fala sobre sua infância na Inglaterra e como seu pai era seu principal cuidador lá. Existem casos semelhantes no material em que os homens desempenham um papel tão central no acolhimento de crianças? +> *"A partir da linha 127, Sarah fala sobre sua infância na Inglaterra e como seu pai era seu principal responsável lá. Existem casos semelhantes no material em que os homens desempenham um papel tão central no acolhimento de crianças? -**Exemplo: Códigos de consolidação** +**Exemplo: Consolidar Códigos** -> *"Tenho a impressão de que os códigos 'Responsabilidade pessoal' e 'Independência' muitas vezes se sobrepõem. Veja os memorandos e passagens codificadas. Como poderíamos distinguir os códigos mais claramente? Ou seria melhor fundi-los?"* +> *"Tenho a impressão de que os códigos 'Responsabilidade pessoal' e 'Independência' muitas vezes se sobrepõem. Veja os memorandos e passagens codificadas. Como poderíamos distinguir os códigos mais claramente? Ou seria melhor mesclá-los?"* > -> Então: *"OK, mesclar ambos os códigos sob o novo nome 'Tomando responsabilidade por si mesmo' e atualizar o memorando de código em conformidade."* +> Então: *"OK, mescle ambos os códigos sob o novo nome 'Tomando responsabilidade por si mesmo' e atualize o memorando de código em conformidade."* **Exemplo: Recuperação de informações** -> *Examinar todas as entrevistas para identificar a posição de cada entrevistado sobre restrições ao uso das redes sociais por crianças e/ou adolescentes. Atribuir cada entrevistado a exatamente uma categoria: -> **pro** = explicitamente a favor das restrições; -> **contra** = explicitamente contra restrições; -> **indeciso** = afirmações relevantes que são ambivalentes, contraditórias ou que não podem ser claramente atribuídas; -> **desconhecido** = nenhuma declaração suficientemente relevante. -> Considere apenas posições que possam ser claramente atribuídas ao entrevistado e verifique o contexto das passagens que encontrar. Primeiro, mostre-me a categoria proposta para cada pessoa, uma breve explicação, e as passagens-chave com referências de origem. Identificar explicitamente contradições e atribuições incertas. -> Somente depois de confirmar, crie o atributo "social media restriction" para as transcrições da entrevista com os valores permitidos "pro", "contra", "indeciso" e "desconhecido", e salve as atribuições.* +> *Examine todas as entrevistas para identificar a posição de cada entrevistado sobre restrições ao uso das redes sociais por crianças e/ou adolescentes. Atribua a cada entrevistado exatamente uma categoria: +> _**pró** = explicitamente a favor das restrições;_ +> _**contra** = explicitamente contra restrições;_ +> _**indeciso** = afirmações relevantes que são ambivalentes, contraditórias ou que não podem ser claramente atribuídas;_ +> _**desconhecido** = nenhuma declaração suficientemente relevante._ +> *Considere apenas posições que possam ser claramente atribuídas ao entrevistado e verifique o contexto das passagens que encontrar. Primeiro, mostre-me a categoria proposta para cada pessoa, uma breve explicação, e as passagens-chave com referências de origem. Identificar explicitamente contradições e atribuições incertas.* +> *Somente depois de confirmar, crie o atributo "restrição das redes sociais" para as transcrições da entrevista com os valores permitidos "pró", "contra", "indeciso" e "desconhecido", e salve as atribuições.* Para incorporar ** prompts predefinidos ou seus próprios prompts** a partir do [Biblioteca AI Prompt](./6.3.-AI-Prompt-Library.md) na conversa, use 'slash notation': por exemplo, "/in-vivo-coding" inseriria o prompt correspondente que você criou anteriormente na Biblioteca Prompt na conversa atual. -### 2) Exploração de tópicos {#2-topic-exploration} +### 2) Explorar tópicos {#2-topic-exploration} -Este tipo de análise é particularmente útil para obter uma ** visão inicial** de como um determinado tópico é discutido no material empírico. Para perguntas de pesquisa simples com tópicos claramente definidos, você também pode usar esta função para produzir análises de resumo que podem ser desenvolvidas diretamente em um relatório. +Este tipo de análise é particularmente útil para obter uma **visão inicial** de como um determinado tópico é discutido no material empírico. Para perguntas de pesquisa simples com tópicos claramente definidos, você também pode usar esta função para produzir análises sintéticas que podem ser desenvolvidas diretamente em um relatório. -- Esta opção abre um **dialog** onde você pode definir e descrever o tópico e selecionar os dados a incluir na análise. -- Você também pode escolher entre diferentes **prompts analíticos**, como um simples resumo (tópico-síntese) ou uma análise de caso comparativa (análise-diferenças). Você pode criar modelos para suas próprias análises com instruções detalhadas no [Biblioteca AI Prompt](./6.3.-AI-Prompt-Library.md) e depois usá-los aqui. +- Esta opção abre uma **caixa de diálogo** em que você pode definir e descrever o tópico e selecionar os dados a incluir na análise. +- Você também pode escolher entre diferentes **_prompts_ analíticos**, como um simples resumo (_topic-summary_) ou uma análise de caso comparativa (_analyze-differences_). Você pode criar modelos para suas próprias análises com instruções detalhadas na [Biblioteca de _Prompts_ de IA](./6.3.-AI-Prompt-Library.md) e depois usá-los aqui. - A exploração de tópicos primeiro realiza uma pesquisa multi-passo através do material e, em seguida, apresenta um relatório inicial. -**Exemplo: Comparação exploratória de casos +**Exemplo: Comparação exploratória de casos** -> ** Topic:** "Criar crianças durante a guerra" -> **Descrição:** "Como a guerra afeta a decisão de ter filhos? Como é que o trabalho de cuidado muda durante a guerra? Como os pais tentam tornar possível a infância em condições de guerra?" -> ** Prompt de análise:** "análise-diferenças" -> **Filter:** Apenas os casos "Ethel" e "Flora" selecionados. +> _** Tópico:** "Criar crianças durante a guerra"_ +> _**Descrição:** "Como a guerra afeta a decisão de ter filhos? Como é que o trabalho de cuidado muda durante a guerra? Como os pais tentam tornar possível a infância em condições de guerra?"_ +> _** _Prompt_ de análise:** "_analyze-differences_" _ +> _**Filtro:** Apenas os casos "Ethel" e "Flora" selecionados_. > -> **Resultado:** Uma análise comparativa de Ethel e Flora sobre o tema "Levantando crianças durante a guerra", estruturado em torno das três subquestões. +> _**Resultado:** Uma análise comparativa de Ethel e Flora sobre o tema "Levantando crianças durante a guerra", estruturado em torno das três subquestões_. ### 3) Análise de texto {#3-text-analysis} -- Permite **fechar análise de uma passagem selecionada** com o agente IA. +- Permite **fechar a análise de uma passagem selecionada** com o agente IA. - Desenvolver novas leituras e sugestões de código juntos, ou discutir ambiguidades, incertezas e questões de interpretação não resolvidas. -Esta análise primeiro muda para o espaço de trabalho de codificação de texto**. -Abra ali um documento, selecione a passagem que deseja analisar e escolha "Ai Text Analysis" no menu com o botão direito do mouse. A **submenu** abre onde você pode escolher entre diferentes tipos de análise de texto: +Esta análise primeiro muda para o espaço de trabalho de **Codificar texto**. +Abra ali um documento, selecione a passagem que deseja analisar e escolha "Análise de texto de IA" no menu com o botão direito do _mouse_. Um **submenu** abre onde você pode escolher entre diferentes tipos de análise de texto: -![Imagem do submenu de análise de texto](../../images/0554a1b0-ee82-433e-bfd1-2f9065df833c.png){largura="600"} +![Imagem do submenu de análise de texto](../../images/0554a1b0-ee82-433e-bfd1-2f9065df833c.png){width="600"} Passe por cima de uma entrada brevemente para ver uma dica com mais informações. -Você também pode salvar suas próprias instruções de análise de texto no [Biblioteca AI Prompt](./6.3.-AI-Prompt-Library.md). Eles aparecerão então como opções neste submenu também. +Você também pode salvar suas próprias instruções de análise de texto no [Biblioteca de _Prompts_ de IA](./6.3.-AI-Prompt-Library.md). Eles aparecerão então como opções neste submenu também. -**Exemplo: Brainstorming nos estágios iniciais da leitura próxima** +**Exemplo: _Brainstorming_ nos estágios iniciais da leitura próxima** -> a) **Select** uma passagem de entrevista particularmente rica na aba "Código texto". -> b) Botão direito do mouse, em seguida, escolha "AI Text Analysis" > **"interactive-brainstorming-with-ai"**. -> c) A área de trabalho muda para o separador "AI Agent". Lá, o agente primeiro pergunta sobre a ** perspectiva analítica** ou o tópico que você gostaria de explorar em mais profundidade. -> d) Uma ** conversa sobre o material** então começa, em que você explora e discute diferentes interpretações possíveis juntos. -> e) **Salvar os resultados:** Quando terminar, instrua o agente de IA a guardar um resumo dos resultados como uma anotação de texto. +> _a) **Selecione** uma passagem de entrevista particularmente rica na aba "Codificar texto"_. +> _b) Botão direito do mouse, em seguida, escolha "AI Text Analysis" > **"interactive-brainstorming-with-ai"**._ +> _c) A área de trabalho muda para a aba "Agente de IA". Lá, o agente primeiro pergunta sobre a **perspectiva analítica** ou o tópico que você gostaria de explorar em mais profundidade._ +> _d) Uma **conversa sobre o material** então começa, em que vocês exploram e discutem diferentes interpretações possíveis juntos_. +> _e) **Salvar os resultados:** Quando terminar, instrua o agente de IA a guardar um resumo dos resultados como uma anotação de texto_. ### 4) Análise de código {#4-code-analysis} -- Analisa todos os **dados recolhidos sob um determinado código ou categoria,** incluindo subcódigos. -- Discuta seus códigos com o agente de IA, compare códigos diferentes, crie subcódigos ou produza relatórios. -- Você também pode selecionar **multiple codes and/ou categories** para uma análise comparativa ou resumida. +- Analisa todos os **dados recolhidos sob um determinado código ou categoria**, incluindo subcódigos. +- Discute seus códigos com o agente de IA, compare códigos diferentes, crie subcódigos ou produza relatórios. +- Você também pode selecionar **múltiplos códigos e/ou categorias** para uma análise comparativa ou resumida. ![Imagem de uma conversa de análise de código](../../images/64423034-a9f8-4e7f-ab99-f50853b155b3.png) -Uma nova análise de código também começa abrindo um **dialog** onde você pode selecionar o(s) código(s) ou categorias para analisar, filtrar os dados para incluir e escolher um prompt analítico. -Você pode criar seus próprios prompts para esta função no [Biblioteca AI Prompt](./6.3.-AI-Prompt-Library.md) Também. +Uma nova análise de código também começa abrindo uma **janela de diálogo** em que você pode selecionar o(s) código(s) ou categorias para analisar, filtrar os dados para incluir e escolher um prompt analítico. +Você pode criar seus próprios prompts para esta função no [Biblioteca de _Prompts_ de IA](./6.3.-AI-Prompt-Library.md) Também. -** Exemplo:** +**Exemplo:** -> **Código:** "Solidariedade da vizinhança" -> ** Prompt de análise:** "teórico-saturação-verificação" -> **Filter:** Nenhum filtro (= todos os documentos estão incluídos). +> _**Código:** "Solidariedade da vizinhança_" +> _**_Prompt_ de análise:** "theoretical-saturation-check_" +> _**Filtro:** Nenhum filtro (= todos os documentos estão incluídos)_. > -> ** Resultado:** Um relatório detalhado sobre a "saturação teórica" do código atual ou categoria selecionada no sentido da teoria fundamentada. O agente de IA busca ativamente o material para variações ainda não codificadas do fenômeno captado pelo código, para casos limítrofes e contraexemplos, para avaliar a saturação empírica e conceitual/teórica do código e identificar lacunas. O memorando de código também é levado em conta. +> _**Resultado:** Um relatório detalhado sobre a "saturação teórica" do código atual ou categoria selecionada no sentido da teoria fundamentada. O agente de IA busca ativamente o material para variações ainda não codificadas do fenômeno captado pelo código, para casos limítrofes e contraexemplos, para avaliar a saturação empírica e conceitual/teórica do código e identificar lacunas. O memorando de código também é levado em consideração_. -## Uma reflexão final sobre o antropomorfismo {#a-final-reflection-on-anthropomorphism} +## Uma reflexão final sobre antropomorfismo {#a-final-reflection-on-anthropomorphism} -Decidimos deliberadamente contra dar um nome ao agente de IA em QualCoder, como o "Claude" da Anthropic. No entanto, a abordagem da QualCoder à integração de IA através do diálogo encena uma espécie de pseudo-interação que, em muitos aspectos, segue padrões de interação humana, por exemplo, dentro de uma equipe de pesquisa. Na sua [prompt do sistema central](https://github.com/ccbogel/QualCoder/blob/master/src/qualcoder/ai_prompts/_agent.md), o agente de IA em QualCoder é atribuído precisamente esse papel como uma espécie de membro da equipe. Estamos, portanto, antropomorfizando uma máquina interagindo com ela como se fosse um pesquisador humano? +Decidimos deliberadamente contra dar um nome ao agente de IA do QualCoder, como o "Claude" da Anthropic. No entanto, a abordagem do QualCoder à integração de IA através do diálogo encena uma espécie de pseudo-interação que, em muitos aspectos, segue padrões de interação humana, por exemplo, dentro de uma equipe de pesquisa. No seu [_prompt_ central do sistema](https://github.com/ccbogel/QualCoder/blob/master/src/qualcoder/ai_prompts/_agent.md), o agente de IA do QualCoder é atribuído precisamente esse papel como uma espécie de membro da equipe. Estamos, portanto, antropomorfizando uma máquina interagindo com ela como se fosse um pesquisador humano? -Até certo ponto, estamos. Mas me parece muito útil ver essas interações como uma espécie de "jogo de papel", como proposto por [Shanahan, McDonell & Reynolds 2023](https://www.nature.com/articles/s41586-023-06647-8)Os modelos de linguagem de IA atuais são treinados em interações linguísticas humanas. Eles, portanto, funcionam melhor quando incorporados em tais configurações de interação. No entanto, uma abordagem metodologicamente reflexiva da IA na pesquisa social qualitativa requer lembrar que estamos nos engajando em um papel induzido tecnologicamente, em vez de interagir com uma contraparte humana. +Até certo ponto, estamos. Mas me parece muito útil ver essas interações como uma espécie de "_role play_(jogo de interpretação de papéis)", como proposto por [Shanahan, McDonell e Reynolds (2023)](https://www.nature.com/articles/s41586-023-06647-8). Os modelos de linguagem de IA atuais são treinados em interações linguísticas humanas. Eles, portanto, funcionam melhor quando incorporados em tais configurações de interação. No entanto, uma abordagem metodologicamente reflexiva da IA na pesquisa social qualitativa requer lembrar que estamos nos engajando em um papel induzido tecnologicamente, em vez de interagir com uma contraparte humana. ## Outras funções {#further-functions} -- No **[Biblioteca AI Prompt](./6.3.-AI-Prompt-Library.md)**, você pode salvar estratégias analíticas bem sucedidas e abordagens metodológicas como instruções reutilizáveis para mais tarde. -- **[AI Codificação Assistida](./4.2.-AI-Assisted-Coding.md)** na área de trabalho 'Code text' usa uma pesquisa baseada em IA para ajudá-lo a encontrar passagens relevantes para um determinado código em todo o corpus. -- Se você tiver **perguntas sobre o uso do QualCoder**, o agente de IA pode ajudar com isso também, fornecendo respostas baseadas na documentação do QualCoder. Selecione * Ajuda > Pergunte ao agente de IA* no menu principal. \ No newline at end of file +- Na **[Biblioteca de _Prompts_ de IA](./6.3.-AI-Prompt-Library.md)**, você pode salvar estratégias analíticas bem sucedidas e abordagens metodológicas como instruções reutilizáveis para mais tarde. +- A **[Codificação Assistida por IA](./4.2.-AI-Assisted-Coding.md)** na área de trabalho 'Codificar texto' usa uma pesquisa baseada em IA para ajudá-lo a encontrar passagens relevantes para um determinado código em todo o _corpus_. +- Se você tiver **dúvidas sobre o uso do QualCoder**, o agente de IA pode ajudar com isso também, fornecendo respostas baseadas na documentação do QualCoder. Selecione *Ajuda > Pergunte ao agente de IA* no menu principal. \ No newline at end of file diff --git a/docs/doc/pt/index.md b/docs/doc/pt/index.md index 63a05de8..69c940b8 100644 --- a/docs/doc/pt/index.md +++ b/docs/doc/pt/index.md @@ -5,12 +5,12 @@ path: index O QualCoder é um software livre e de código aberto para análise de dados qualitativos. -O QualCoder você pode codificar texto, imagens, áudio e vídeo, escrever notas de diário e memorandos. Você pode organizar códigos em um esquema de categorização em árvore. Vários tipos de relatórios podem ser gerados. A maioria dos relatórios pode ser exportada como html, texto de documento aberto (ODT), texto simples ou arquivos de Excel (XLSX). +Com o QualCoder você pode codificar texto, imagens, áudio e vídeo, escrever notas de diário e memorandos. Você pode organizar códigos em um esquema de categorização em árvore. Vários tipos de relatórios podem ser gerados. A maioria dos relatórios pode ser exportada como html, texto de documento aberto (ODT), texto simples ou arquivos de Excel (XLSX). O QualCoder inclui um conjunto de recursos assistidos por IA que utilizam modelos de linguagem grandes para ajudar a explorar, analisar e interagir com dados de formas inovadoras. Familiarize-se com novos dados explorando amplos tópicos ou conceitos em um chat interativo com a IA. Mergulhe mais em aspectos específicos com codificação assistida por IA e análise de texto. E se você chegar ao ponto em que você deve sintetizar e consolidar seus resultados, discuta-os em uma conversa de código com a IA. !!! note "Por que usar o QualCoder?" - - **QualCoder é gratuito**. Muitos programas de análise qualitativa cobram taxas úncias ou assinaturas mensais caríssimas. + - **O QualCoder é gratuito**. Muitos programas de análise qualitativa cobram taxas úncias ou assinaturas mensais caríssimas. - **O QualCoder é fácil de usar**. Ele tem tudo que você precisa para realizar análises qualitativas sem as interfaces complicadas de algumas alternativas - **O QualCoder funciona _offline_**. A Internet nem sempre está disponível e QualCoder não requer internet para trabalhar. @@ -19,8 +19,8 @@ O QualCoder inclui um conjunto de recursos assistidos por IA que utilizam modelo - **O QualCoder depende da comunidade**. Se você encontrar um erro ou tiver um pedido de recurso ou _feedback_, escreva sobre ele na [página do QualCoder no github](https://github.com/ccbogel/QualCoder). - **O QualCoder está sempre melhorando**. O QualCoder é desenvolvido ativamente, o que significa que versões novas e melhoradas estão sendo lançadas. - **O QualCoder suporta padrões abertos**. O QualCoder busca apoiar o [Padrão REFI-QDA](https://www.qdasoftware.org/), você pode trocar _codebooks_ e projetos com seus colegas, mesmo que eles não usem o QualCoder, desde que o software que eles usam suporte o padrão REFI-QDA. Significa que você não corre o risco de seus dados ficarem indisponíveis.A compatibilidade dos projetos com o REFI-QDA ainda não está 100% garantida. São necessários mais testes, em especial para as exportações e importações de áudio e vídeo e arquivos ligados relativamente. - - **QualCoder pode ser modificado**. Você pode modificar e adaptar o QualCoder às suas necessidades, desde que libere suas alterações para todos. Isso também significa que você pode copiar o _software_ e dá-lo a seus colegas ou alunos gratuitamente. - - **QualCoder é uma opção de software para apoiar a ciência aberta**. [Recomendações da UNESCO sobre ciência aberta (em inglês)](https://www.unesco.org/en/open-science?hub=686) + - **O QualCoder pode ser modificado**. Você pode modificar e adaptar o QualCoder às suas necessidades, desde que libere suas alterações para todos. Isso também significa que você pode copiar o _software_ e dá-lo a seus colegas ou alunos gratuitamente. + - **O QualCoder é uma opção de _software_ para apoiar a ciência aberta**. [Recomendações da UNESCO sobre ciência aberta (em inglês)](https://www.unesco.org/en/open-science?hub=686) ## Versão atual {#current-release}