Como usar o Markup
Introdução
Este manual tem como objetivo apresentar o uso do programa de marcação Markup
Sugestão de Atribuição de “ID”
O atributo “ID” é usado para identificar alguns elementos, tornando possível estabelecer referências cruzadas entre sua chamada no decorrer do texto e o elemento em si, como figuras, tabelas, afiliações etc. Para composição do “ID” combine o prefixo do tipo do elemento e um número inteiro, como segue:
Elemento XML | Descrição | Prefixo | Exemplo |
---|---|---|---|
aff | Afiliação | aff | aff1, aff2, … |
app | Apêndice | app | app1, app2, … |
author-notes/fn | fn-group/fn | Notas de rodapé do artigo | fn | fn1, fn2, … |
boxed-text | Caixa de texto | bx | bx1, bx2, … |
corresp | Correspondência | c | c1, c2, … |
def-list | Lista de Definições | d | d1, d2, … |
disp-formula | Equações | e | e1, e2, … |
fig | Figuras | f | f1, f2, … |
glossary | Glossário | gl | gl1, gl2, … |
media | Media | m | m1, m2, … |
ref | Referência bibliográfica | B | B1, B2, … |
sec | Seções | sec | sec1, sec2, … |
sub-article | sub-artigo | S | S1, S2, … |
supplementary-material | Suplemento | suppl | suppl1, suppl2, … |
table-wrap-foot/fn | Notas de rodapé de tabela | TFN | TFN1, TFN2, … |
table-wrap | Tabela | t | t1, t2, … |
Dados Básicos
Estando o arquivo formatado de acordo com o manual Preparação de Arquivos para o Programa Markup e aberto no programa Markup, selecione a tag [doc]:
Ao clicar em [doc] o programa abrirá um formulário para ser completado com os dados básicos do artigo:
Ao selecionar o periódico no campo “collection/journal” o programa preencherá alguns dados automaticamente, tais como: ISSNs, título abreviado, acrônimo, entre outros. Os demais dados serão preenchidos manualmente, de acordo com as orientações abaixo:
Campo | Descrição |
---|---|
license | Se não for inserido automaticamente, preencher com a URL da licença Creative Commons adotada pelo periódico. Consultar licenças em: http://docs.scielo.org/projects/scielo-publishing-schema/pt_BR/latest/tagset/elemento-license.html |
volid | Inserir volume, se houver. Para ahead of print, não incluir volume |
supplvol | Caso seja um suplemento de volume incluir sua parte ou número correspondente. Por exemplo, para o vol.12 supl.A, preencha esse campo com “A” |
issueno | Insira o número do fascículo. Caso seja um artigo para publicação em ahead of print, insira “ahead” neste campo |
supplno | Caso seja um suplemento de fascículo, incluir sua parte ou número correspondente. Por exemplo, para o n.37, supl.A, preencha esse campo com “A” |
isidpart | Usar em casos de press release, incluindo a sigla “pr” |
dateiso | Data de publicação formada por ano, mês e dia (YYYYMMDD). Preencher sempre com o último mês da periodicidade. Por exemplo, se o periódico é bimestral preencher “20140600”. Use “00” para mês e dia nos casos em que não são identificados. Por exemplo: “20140000” |
month/season | Entre o mês ou mês inicial + barra + mês final, em inglês (três letras) e ponto, exceto para May, June e July. Por exemplo: May/June, July/Aug. |
fpage | Número da primeira página do documento. Para artigo em ahead of print, incluir “00” |
@seq | Para artigos que iniciam na mesma página de um artigo anterior, incluir a sequência com letra. Por exemplo: “23b” |
lpage | Inserir o número da última página do documento |
elocatid | Incluir paginação eletrônica. Neste caso não preencher fpage e lpage |
order (in TOC) | Incluir a ordem do artigo no sumário do fascículo. Deve ter, no mínimo, dois dígitos. Por exemplo, se o artigo for o primeiro do sumário, preencha este campo com “01” e assim por diante |
doctopic* | Informar o tipo de documento a ser marcado. Por exemplo: artigo original, resenha, carta, comentário etc. No caso de ahead of print, incluir sempre o tipo “artigo original”, exceto para errata |
language* | Informe o idioma principal do texto a ser marcado |
sps-version* | Identifica a versão do SciELO Publishing Schema (http://docs.scielo.org/projects/scielo-publishing-schema/pt_BR/latest/) usada no processo de marcação (a versão atual é 1.5) |
artdate (rolling) | Obrigatório completar com a data formada por ano, mês e dia (YYYYMMDD) quando for um artigo de um periódico que usa o modelo de publicação contínua, onde os artigos são publicados à medida em que ficam prontos |
ahpdate | Indicar a data de publicação de um artigo publicado em ahead of print |
Note
Os campos que apresentam um asterisco ao lado são obrigatórios.
Front
Tendo preenchido todos os campos, ao clicar em “Ok” será aberta uma janela perguntando se o arquivo está na formatação adequada para efetuar a marcação automática:
Ao clicar em “Sim”, o programa efetuará a marcação automática dos elementos básicos do documento.
Note
Caso o arquivo não esteja na formatação recomendada em Preparação de Arquivos para o Programa Markup, o programa não identificará corretamente os elementos.
Após a marcação automática é necessário completar a marcação dos elementos básicos.
Doctitle
Confira o idioma inserido em [doctitle] para títulos traduzidos e se necessário, corrija. Para corrigir, selecione a tag cujo atributo precisa ser corrigido e clique no botão “Markup: Editar atributos” (lápis) para editá-lo:
Faça o mesmo para os demais títulos traduzidos.
Autores
Alguns autores apresentam mais que um label ao lado do nome, porém o programa não faz a marcação automática de mais que um label. Para isso, selecione o label do autor e o identifique com o elemento [xref].
Por se tratar de referência cruzada (xref) de afiliação, o tipo de xref (ref-type) selecionado foi o “affiliation” e o rid (relacionado ao “ID”) “aff3” para relacionar o label 3 à afiliação correspondente.
O programa Markup não faz a marcação automática de função de autor como, por exemplo, o cargo exercido. Para isso é necessário selecionar a informação que consta ao lado do nome do autor, ir para o nível inferior do elemento [author] e identificar esse dado com a tag [role]. Veja:
Note
O programa não identifica automaticamente símbolos ou letras como label, que devem ser marcados manualmente, observando o tipo de referência cruzada a ser incluída.
Sig-block
Geralmente arquivos Editoriais, Apresentações etc possuem ao final do texto a assinatura do autor ou editor. Para identificar a assinatura do autor, seja em imagem ou texto, é necessário selecionar a assinatura e identificar com a tag [sigblock] (no nível inferior da tag [xmlbody]):
Após isso, selecione apenas a assinatura e faça a identificação com a tag [sig]:
Note
Algumas assinaturas apresentam ao lado o cargo ou função do autor. Para a identificação de [sig], não considerar a função.
Faça então a idenficação da assinatura, identificando [fname] e [surname]. Abaixo o resultado da identificação de assinatura do autor/editor:
On Behalf
O elemento [on-behalf] é utilizado quando um autor exerce papel de representante de um grupo ou organização. Para identificar esse dado, verifique se a informação do representante do grupo está na mesma linha do autor. Exemplo:
Fernando Augusto Proietti 2 Interdisciplinary HTLV Research Group
O programa identificará o autor “Fernando Augusto Proietti” da seguinte forma:
Agora selecione o nome do grupo ou organização e identifique com a tag: [onbehalf]:
Contrib-ID
Autores que apresentam registro no ORCID ou no Lattes devem inserir o link de registro ao lado do nome, após o label do autor:
Ao fazer a marcação de [doc] o programa identificará automaticamente todos os dados iniciais do documento, inclusive marcará em [author] o link de registro do autor. Ainda que o programa inclua o link na tag [author], será necessário completar a marcação desse dado.
Para isso, entre no nível de [author], selecione o link do autor e clique em [author-id]. Na janela aberta pelo programa, selecione o tipo de registro do autor: se lattes ou ORCID e clique em “Continuar”.
Afiliações
O programa Markup faz a identificação apenas de grupo de dados de cada afiliação com o elemento [normaff], ou seja, o detalhamento das afiliações não é feito automaticamente. Complete a marcação de afiliações identificando: instituição maior [orgname], divisão 1 [orgdiv1], divisão 2 [orgdiv2], cidade [city], estado [state] (esses 4 últimos, se presentes) e o país [country].
Para fazer a identificação dos elementos acima vá para o nível inferior do elemento [normaff] e faça o detalhamento de cada afiliação.
Após o detalhamento de afiliações, será necessário verificar se a instituição marcada e país correspondente possuem forma normalizada pelo SciELO. Para isso, selecione o elemento [normaff] e clique no botão “Markup: Editar atributos” (lápis) para editar os atributos. O programa abrirá uma janela para normalização dos elementos indicados nos campos em branco.
No campo “icountry” selecione o país da instituição maior (orgname), em seguida clique em “find” para encontrar a instituição normalizada. Ao fazer esse procedimento, o programa Markup consultará nossa base de dados de instituições normalizadas e verificará se a instituição selecionada consta na lista.
Note
Faça a busca pelo idioma de origem da instituição, exceto para línguas não latinas, quando a consulta deverá ser feita em inglês. Caso a instituição não exista na lista do Markup, selecione o elemento “No match found” e clique em “OK”.
Resumos
Os resumos devem ser identificados manualmente. Para marcação de resumos simples (sem seções) e para os resumos estruturados (com seções) utilizar o elemento [xmlabstr]. Na marcação, selecione o título do resumo e o texto e em seguida marque com o botão [xmlabstr].
Resumo sem Seção:
Selecionando:
Quando clicar em [xmlabstr] o programa abrirá uma janela onde deve-se selecionar o idioma do resumo marcado:
Marcação:
Resultado:
Já em resumos estruturados, o programa também marcará cada seção do resumo e seus respectivos parágrafos.
Resumo com Seção:
Siga os mesmos passos descritos para resumo sem seção:
Selecionando:
Marcação:
Resultado:
Keywords¶
O programa Markup apresenta dois botões para identificação de palavras-chave, [*kwdgrp] e [kwdgrp]. O botão [*kwdgrp], com asterisco, é utilizada para identificação automática de cada palavra-chave e do título. Para isso, selecione toda a informação – inclusive o título – e identifique os dados com o elemento [*kwdgrp].
Marcação Automática:
Selecionando:
Ao clicar em [*kwdgrp] o programa abrirá uma janela para seleção do idioma das palavras-chave marcadas:
Marcação:
Resultado:
Marcação Manual:
Caso a marcação automática não ocorra conforme o esperado, pode-se marcar o grupo de palavras-chave manualmente. Selecione o grupo de palavras-chave e marque com o elemento [kwdgrp].
Marcação:
Em seguida, faça a identificação de item por item. Para tanto, selecione o título das palavras-chave e identifique com o elemento [sectitle]:
Na sequência, selecione palavra por palavra e marque com o elemento [kwd]:
Note
Quando estiver fazendo a marcação manual das palavras-chave, note que o separador não deverá ser inserido dentro da tag [kwd] .
History
O elemento [hist] é utilizado para marcar o histórico do documento. Selecione todo o dado de histórico e marque com o elemento [hist]:
Selecione, então, a data de recebimento e marque com o elemento [received]. Confira a data ISO indicada no campo “dateiso” e corrija, se necessário. A estrutura da data ISO esperada nesse campo é ANO MÊS DIA. Veja:
Caso haja a data de revisão, selecione-a e marque com o elemento [revised]. Faça o mesmo para a data de aceite, selecionando o elemento [accepted]. Confira a data ISO indicada no campo “dateiso” e corrija, se necessário.
Correspondência
Com o elemento [corresp] é possível marcar os dados de correspondência do autor. Esse elemento possui um subnível para identificação do e-mail do autor. Selecione toda a informação de correspondência e marque com o elemento [corresp]. Será apresentada uma janela para marcação do ID de correspondência que, nesse caso, deve ser “c” + o número de ordem da correspondência.
Selecione o e-mail do autor correspondente e marque com o elemento [email].
Ensaio Clínico
Arquivos que apresentam informação de ensaio clínico com número de registro, devem ser marcados com o elemento [cltrial]:
Na janela aberta pelo programa, preencha o campo de URL da base de dados onde o Ensaio foi indexado no campo “cturl” e preencha o campo “ctdbid” selecionando a base correspondente. Para encontrar a URL do ensaio clínico faça uma busca na internet pelo número de registro.
Resultado:
Note
Comumente a informação de Ensaio clínico está posicionada abaixo dos resumos ou palavras-chave.
Referências
As referências bibliográficas são marcadas elemento a elemento e seu formato original é mantido para apresentação no site do SciELO.
O programa marcará todas as referências selecionadas com o elemento [ref] do tipo [book]. A alteração do tipo de referência será manual ou automática, dependendo do tipo de elemento marcado, conforme será observado mais adiante.
Tipos de Referências
A partir da marcação feita, alguns tipos de referência serão alterados automaticamente sem intervenção manual (ex.: tese, conferência, relatório, patente e artigo de periódico); já para os demais casos, será necessária a alteração manual. Para alterar o tipo de referência clique no elemento [ref], em seguida, no lápis “Editar Atributos” e em “reftype” para selecionar o tipo correto.
Recomenda-se a edição de “reftype” somente após marcar todos os elementos da [ref], pois dependendo dos elementos marcados o “reftype” pode ser alterado automaticamente pelo Markup.
Note
Uma referência deve ter sua tipologia sempre baseada no seu conteúdo e nunca no seu suporte. Por exemplo, uma lei representa um documento legal, portanto o tipo de referência é “legal-doc”, mesmo que esteja publicado em um jornal ou site. Uma referência de artigo de um periódico científico, mesmo que publicado em um site possui o tipo “journal”. É importante entender estes aspectos nas referências para poder interpretar sua tipologia e seus elementos. Nem toda referência que possui um link é uma “webpage”, nem toda a referência que possui um volume é um “journal”, livros também podem ter volumes.
Abaixo seguem os tipos de referência suportados por SciELO e a marcação de cada [ref].
Thesis
Utilizada para referenciar monografias, dissertações ou teses para obtenção de um grau acadêmico, tais como livre-docência, doutorado, mestrado, bacharelado, licenciatura etc. A seleção do elemento [thesgrp] determinará a alteração do tipo [book] para [thesis]. Ex:
PINHEIRO, Fernanda Domingos. Em defesa da liberdade: libertos e livres de cor nos tribunais do Antigo Regime português (Mariana e Lisboa, 1720-1819). Tese de doutorado, Departamento de História, Instituto de Filosofia e Ciências Humanas, Universidade Estadual de Campinas, 2013
Confproc
Utilizada para referenciar documentos relacionados à eventos: atas, anais, convenções, conferências entre outros. Ao marcar o elemento [confgrp] o programa alterará o tipo de referência para [confproc]. Ex.:
FABRE, C. Interpretation of nominal compounds: combining domain-independent and domain-specific information. In: INTERNATIONAL CONFERENCE ON COMPUTATIONAL LINGUISTICS (COLING), 16, 1996, Stroudsburg. Proceedings… Stroudsburg: Association of Computational Linguistics, 1996. v.1, p.364-369.
Report
Utilizada para referenciar relatórios técnicos, normalmente de autoria institucional. Ao marcar o elemento [reportid] o programa alterará o tipo de referência para [report]. Ex.:
AMES, A.; MACHADO, F.; RENNÓ, L. R. SAMUELS, D.; SMITH, A.E.; ZUCCO, C. The Brazilian Electoral Panel Studies (BEPS): Brazilian Public Opinion in the 2010 Presidential Elections. Technical Note No. IDB-TN-508, Inter-American Development Bank, Department of Research and Chief Economist, 2013.
Note
Nos casos em que não houver número de relatório, a alteração do tipo de referência deverá ser feita manualmente.
Patent
Utilizada para referenciar patentes; a patente representa um título de propriedade que confere ao seu titular o direito de impedir terceiros explorarem sua criação.. Ex.:
SCHILLING, C.; DOS SANTOS, J. Method and Device for Linking at Least Two Adjoinig Work Pieces by Friction Welding, U.S. Patent WO/2001/036144, 2005.
Book
Utilizada para referenciar livros ou parte deles (capítulos, tomos, séries e etc), manuais, guias, catálogos, enciclopédias, dicionários entre outros. Ex.:
LORD, A. B. The singer of tales. 4th. Cambridge: Harvard University Press, 1981.
Book no prelo
Livros finalizados, mas ainda não publicados apresentam a informação “no prelo”, “forthcomming” ou ““in press”” normalmente ao final da referência. Nesse caso, a marcação será feita conforme indicado abaixo:
CIRENO, F.; LUBAMBO, C. Estratégia eleitoral e eleições para Câmara dos Deputados no Brasil em 2006, no prelo.
Book Chapter
Divisão de um livro (título do capítulo e seus respectivos autores, se houver, seguido do título do livro e seus autores) numerado ou não
Lastres, H.M.M.; Ferraz, J.C. Economia da informação, do conhecimento e do aprendizado. In: Lastres, H.M.M.; Albagli, S. (Org.). Informação e globalização na era do conhecimento. Rio de Janeiro: Campus, 1999. p.27-57.
journal
Utilizada para referenciar publicações seriadas científicas, como periódicos, boletins e jornais, editadas em unidades sucessivas, com designações numéricas e/ou cronológicas e destinada a ser continuada indefinidamente. Ao marcar [arttile-title] o programa alterará o tipo de referência para [journal]. Ex.:
Cardinalli, I. (2011). A saúde e a doença mental segundo a fenomenologia existencial. Revista da Associação Brasileira de Daseinsanalyse, São Paulo, 16, 98-114.
Nas referências abaixo, seu tipo deverá ser alterado manualmente de [book] para o tipo correspondente.
legal-doc
Utilizada para referenciar documentos jurídicos, incluem informações sobre, legislação, jurisprudência e doutrina. Ex.:
Brasil. Portaria no 1169/GM em 15 de junho de 2004. Institui a Política Nacional de Atenção Cardiovascular de Alta Complexidade, e dá outras providências. Diário Oficial 2004; seção 1, n.115, p.57.
Newspaper
Utilizada para referenciar publicações seriadas sem cunho científico, como revistas e jornais. Ex.:
TAVARES de ALMEIDA, M. H. “Mais do que meros rótulos”. Artigo publicado no Jornal Folha de S. Paulo, no dia 25/02/2006, na coluna Opinião, p. A. 3.
Database
Utilizada para referenciar bases e bancos de dados. Ex.:
IPEADATA. Disponível em: http://www.ipeadata.gov.br. Acesso em: 12 fev. 2010.
Software
Utilizada para referenciar um software, um programa de computador. Ex.:
Nelson KN. Comprehensive body composition software [computer program on disk]. Release 1.0 for DOS. Champaign (IL): Human Kinetics, c1997. 1 computer disk: color, 3 1/2 in.
Webpage
Utilizada para referenciar, web sites ou informações contidas em blogs, twiter, facebook, listas de discussões dentre outros.
Exemplo 1
UOL JOGOS. Fórum de jogos online: Por que os portugas falam que o sotaque português do Brasil é açucarado???, 2011. Disponível em <http://forum.jogos.uol.com.br/_t_1293567>. Acessado em 06 de fevereiro de 2014.
Exemplo 2
BANCO CENTRAL DO BRASIL. Disponível em: www.bcb.gov.br.
Other
Utilizada para referenciar tipos não previstos pelo SciELO. Ex.:
INAC. Grupo Nacional de Canto e Dança da República Popular de Moçambique. Maputo, [s.d.].
“Previous” em Referências
Há normas que permitem que as obras que referenciam a mesma autoria repetidamente, sejam substituídas por um traço sublinear equivalente à seis espaços. Ex.:
______. Another one bites the dust: Merck cans hep C fighter Victrelis as new meds take flight [Internet]. Washington: FiercePharma; 2015.
Ao fazer a marcação de [refs] o programa duplicará a referência com previous da seguinte forma:
[ref id=”r16” reftype=”book”] [text-ref]______. Another one bites the dust: Merck cans hep C fighter Victrelis as new meds take flight [Internet]. Washington: FiercePharma; 2015[/text-ref]. *______. Another one bites the dust: Merck cans hep C fighter Victrelis as new meds take flight [Internet]. Washington: FiercePharma; 2015*[/ref]
Note
Em referências que apresentam o elemento [text-ref], o dado a ser marcado deverá ser o que consta após o [/text-ref]. Nunca fazer a marcação da referência que consta em [text-ref][/text-ref].
Para identificação de referências com esse tipo de dado, selecione os traços sublineares e identifique com a tag [*authors] com asterisco. O programa recuperará o nome do autor previamente marcado e fará a identificação automática do grupo de autores, identificando o sobrenome e o primeiro nome.
Marcação Automática
O programa Markup dispõe de uma funcionalidade que otimiza o processo de marcação das referências bibliográficas que seguem a norma Vancouver. Caso haja adaptações na norma, o programa não fará a identificação corretamente.
Selecione todas as referências
Clique no botão “Markup: Marcação Automática 2”
Apesar do programa fazer a marcação automática das referências, será necessário analisar atentamente referência por referência afim de verificar se algum dado deixou de ser marcado ou foi marcado incorretamente. Se houver algum erro a ser corrigido, entre no nível de [ref] em “Barras de Ferramentas Personalizadas” e faça as correções e/ou inclua as marcações faltantes.
Note
O uso da marcação automática em referências só é possível caso as referências bibliográficas estejam de acordo com a norma Vancouver, seguindo-a literalmente. Para as demais normas tal funcionalidade não está disponível.
Referência numérica
Alguns periódicos apresentam referências bibliográficas numeradas, as quais são referenciadas assim no corpo do texto. O número correspondente à referência também deve ser marcado. Após a marcação do grupo de referências, desça um nível em [ref], selecione o número da referência e marque com o elemento [label]:
Note
O programa Markup não faz a identificação automática desse dado.
Notas de Rodapé
As notas de rodapé podem aparecer antes do corpo do texto ou depois. Não há uma posição específica dentro do arquivo .doc. Entretando é necessário avaliar a nota indicada, pois dependendo do tipo de nota inserido em fn-type, o programa gera o arquivo .xml com informações de notas de autores em <front>
ou em <back>
. Para mais informações sobre essa divisão consultar na documentação SPS os itens <http://docs.scielo.org/projects/scielo-publishing-schema/pt_BR/1.2-branch/tagset.html#notas-de-autor> e <http://docs.scielo.org/projects/scielo-publishing-schema/pt_BR/1.2-branch/tagset.html#notas-gerais>.
Selecione nota e marque com o elemento [fngrp].
Caso a nota apresente um título ou um símbolo, selecione a informação e identifique com o elemento [label]:
Tipos de notas
Suporte sem Informação de Financiamento
Para notas de rodapé que apresentam suporte de entidade, instituição ou pessoa física sem dado de financiamento e número de contrato, selecione a nota do tipo “Pesquisa na qual o artigo é baseado foi apoiado por alguma entidade”:
Suporte com Dados de Financiamento
Para notas de rodapé que apresentam dados de financiamento com número de contrato, selecione nota do tipo “Declaração ou negação de recebimento de financiamento em apoio à pesquisa na qual o artigo é baseado”. Nesse caso, será preciso marcar os dados de financiamento com o elemento [funding]:
O próximo passo será selecionar o primeiro grupo de instituição financiadora + número de contrato e marcar com o elemento [award].
Em seguida, selecione a instituição financiadora e marque com o elemento [fundsrc]:
Depois selecione cada número de contrato e identifique com o elemento [contract]:
Caso a nota de rodapé apresente mais que uma instituição financiadora e número de contrato, faça a marcação conforme o exemplo abaixo:
Notas de Rodapé - Identificação Automática
Para notas de rodapé que estão posicionadas ao fim de cada página no documento, com formatação de notas de rodapé do Word, é possível fazer a marcação automática do número referenciado no documento e sua nota respectiva.
As chamadas de nota de rodapé no corpo do texto deverão estar com uma formatação simples: em formato numérico e sobrescrito. Já as notas, deverão estar em formato de nota de rodapé do Word com um espaço antes da nota.
Estando formatado corretamente, clique com o mouse em qualquer parágrafo e em seguida clique na tag [*fn].
Ao clicar em [*fn] o programa fará a marcação automática de [xref] no corpo do texto e também da nota ao pé da página.
Apêndices
A marcação de apêndices, anexos e materiais suplementares deve ser feita pelo elemento [appgrp]:
Selecione todo o grupo de apêndice, inclusive o título, se existir, e clique em [appgrp]:
Selecione apêndice por apêndice e identifique com o elemento [app]
Note
o id deve ser sempre único no documento.
Caso o apêndice seja de figura, tabela, quadro etc, selecione o título de apêndice e marque com o elemento [sectitle]. Utilize os botões flutuantes (tabwrap, figgrp, *list, etc) do programa Markup para identificação do objeto que será marcado.
botões flutuantes
Exemplo, selecione a figura com seu respectivo label e caption e marque com o elemento [figgrp]
Note
Assegure-se de que o id da figura de apêndice é único no documento.
Para apêndices que apresentam parágrafos, selecione o título do apêndice e marque com o elemento [sectitle]
Selecione o parágrafo e marque com o elemento [p]
Agradecimentos
A seção de agradecimento, geralmente, encontra-se entre o final do corpo do texto e as referências bibliográficas. Para marcação automática dos elementos de agradecimento selecione todo o texto, inclusive o título desse item, e marque com o elemento [ack].
selecionando [ack]
Resultado esperado
Comumente os agradecimentos apresentam dados de financiamento, com número de contrato e instituição financiadora. Quando presentes, marque os dados com o elemento [funding].
Selecione o primeiro conjunto de instituição e número de contrato e marque com o elemento [award]:
Selecione agora a instituição financiadora e marque com o elemento [fundsrc]:
Note
Caso haja mais que uma instituição financiadora para o mesmo número de contrato, selecione cada instituição em um [fundsrc]
Marque o número de contrato com o elemento [contract]:
Quando houver mais de uma instituição financiadora e número de contrato, marcar conforme segue:
Glossário
Glossários são incluídos nos documentos após referências bibliográficas, em apêndices ou caixas de texto. Para marcá-lo, selecione todos os itens que a compõe e marque com o elemento [glossary]. Selecione todos os itens novamente e marque com o elemento lista-definição. Segue exemplo de marcação de glossário presente após referências bibliográficas:
Selecione todos os dados de glossário e marque com o elemento Lista de Definição:
Abaixo o resultado da marcação de glossário:
xmlbody
Tendo formatado o corpo do texto de acordo com o ítem Formatação do Arquivo e após a marcação das referências bibliográficas, é possível iniciar a marcação do [xmlbody].
Selecione todo o corpo do texto e clique no botão [xmlbody], confira as informações de seções, subseções, citações etc as quais são apresentadas na caixa de diálogo e, se necessário, corrija e clique em “Aplicar”.
Note
Caso haja alguma informação incorreta, selecione o item a ser corrigido na janela, clique no menu dropdown ao lado do botão “Corrigir”, selecione a opção correta e clique em “Corrigir”. Confira novamente e clique em “Aplicar”.
Ao clicar em “Aplicar” o programa perguntará se as referências no corpo do texto obedecem o padrão de citação author-data. Se o documento apresenta esse padrão clique em [sim], caso contrário, clique em [não].
Sistema numérico
É a partir da formatação do documento indicada no Formatação do Arquivo que o programa marca automaticamente seções, subseções, parágrafos, referências de autores no corpo do texto, chamadas de figuras e tabelas, equações em linha etc.
Verifique se os dados foram marcados corretamente e complete a marcação dos elementos ainda não identificados no documento.
Seções e Subseções
Após a marcação automática do [xmlbody], certifique-se de que os tipos de seções foram selecionados corretamente.
Em alguns casos, a marcação automática não identifica a seção corretamente. Nesses casos, selecione a seção, clique no lápis “Editar Atributos” e indique o tipo correto de seção.
Resultado
Note
Referência Cruzada de Referências Bibliográficas
Referências no sistema autor-data serão identificados automaticamente no corpo do texto somente se o sobrenome do autor e a data estiverem marcados em Referências Bibliográficas e, apenas se o sobrenome do autor estiver presente no corpo do texto igual ao que foi marcado em [Refs]. Há alguns casos que o programa Markup não irá fazer a marcação automática de [xref] do documento. Ex.:
Citações de autor
Sobrenome do autor + “in press” ou derivados:
Autor corporativo:
Para identificar o [xref] das citações que não foram marcadas automaticamente, primeiramente verifique qual o id da referência bibliográfica não identificada, em seguida selecione a citação desejada e marque com o elemento [xref].
Preencha apenas os campos “ref-type” e “rid”. Em “ref-type” selecione o tipo de referência cruzada que será feito, nesse caso “Referencia Bibliográfica”, em seguida indique o id correspondente à referência bibliográfica citada. Confira e clique no botão [Continuar].
Note
Não insira hiperlink no dado a ser marcado.
Chamada de Quadros, Equações e Caixas de Texto:
A marcação das referências cruzadas de quadros, equações e caixas de texto segue as mesmas etapas descritas em referências bibliográficas.
Quadro:
Selecione [ref-type] do tipo figura e indique a sequência do ID no documento para este elemento.
Equações:
Selecione [ref-type] do tipo equação e indique a sequência do ID no documento para este elemento.
Caixa de Texto:
Selecione [ref-type] do tipo caixa de texto e indique a sequência do ID no documento para este elemento.
Parágrafos
Os parágrafos são marcados automaticamente no corpo do texto ao fazer a identificação de [xmlbody]. Caso o programa não tenha marcado um parágrafo ou caso a marcação automática tenha identificado um parágrafo com o elemento incorreto, é possível fazer a marcação manual desse dado. Para isso, selecione o parágrafo desejado, verifique se o parágrafo pertence a alguma seção ou subseção e encontre o elemento [p] nos níveis de [sec] ou [subsec].
Resultado
Figuras
Ao fazer a marcação de [xmlbody] o programa identifica automaticamente as imagens com o elemento “graphic”.
Para marcar o grupo de dados da figura, selecione a imagem, sua legenda (label e caption) e fonte, se houver e marque com o elemento [figgrp].
Certifique-se de que o id de figura é único no documento.
Note
A marcação completa de figura é de extrema importância. Se a figura não for marcada com o elemento [figgrp] e seus respectivos dados, o programa não gerará o elemento [fig] correspondente no documento.
Note
A marcação de label e caption será automática se estiver conforme as instruções dadas em Formatação do Arquivo, com label e caption abaixo da imagem no arquivo .doc. A informação de fonte deve estar acima da imagem. Veja o exemplo da imagem acima.
Tabelas
As tabelas podem ser apresentadas como imagem ou em texto. As tabelas que estão como imagem devem apresentar o label, caption e notas (essa última, se existir) em texto, para que todos os elementos sejam marcados. As tabelas devem estar, preferencialmente, em formato texto, usandos-se figuras para tabelas complexas (com células mescladas, símbolos, fórmulas, imagens etc).
Tabelas em Imagem
Ao fazer a marcação de [xmlbody] o programa identifica automaticamente o “graphic” da tabela. Selecione todos os dados da tabela (imagem, label, caption e notas de rodapé, se houver) e identifique com o elemento [tabwrap].
Mesmo estando na forma de figura, o id do elemento deverá ser o indicado para tabelas (t1, t2, t3 …). Certifique-se de que o id de tabela é único no documento.
Certifique-se de que o id da tabela é único no documento.
Note
O programa faz a marcação automática de label, caption e notas de rodapé de tabela.
Tabelas em Texto
O programa também codifica tabelas em texto. Para isso, selecionte toda a informação de tabela (label, caption, corpo da tabela e notas de rodapé, se houver) e marque com o elemento [tabwrap].
Note
O cabeçalho das colunas da tabela deve estar em negrito. Essa formatação é essencial para que o programa consiga fazer a identificação correta de [thead] e os elementos que o compõe.
Certifique-se de que o id de tabela é único no documento.
Note
Tabelas irregulares, com células mescladas ou com tamanhos extensos possivelmente apresentarão problemas de marcação. Nesse caso alguns elementos deverão ser identificados manualmente por meio do programa Markup ou no XML quando este for gerado.
Equações
Há dois tipos de equações que o programa suporta: as equações em linha (em meio a um parágrafo) e as equações em parágrafo.
Equação em linha
As equações em linha devem ser inseridas no parágrafo como imagem. A marcação é feita automaticamente pelo programa ao fazer a identificação de [xmlbody].
Se o programa não fizer a marcação automática da equação em linha, é possível fazer a marcação manualmente. Para isso selecione a equação em linha e clique no elemento [graphic].
No campo “href” insira o nome do arquivo:
O resultado será:
Equações
As equações disponíveis como parágrafos devem ser identificadas com o elemento [equation]
Preencha do “id” da equação na janela aberta pelo programa. Certifique-se de que o id da equação é único no documento.
Ao fazer a marcação da equação, o programa identifica o elemento [equation]. Caso haja informação de número da equação, identifique-o com o elemento [label].