Skip to content
Apothem
Comandos do pipeline

/research-publish

/research-publish — Formata o artigo conforme o modelo do veículo e monta o pacote de submissão (suplementar, disponibilidade de dados/código, carta de apresentação, ética/conflito de interesse), com um plano de preprint/DOI.

Papel: Pesquisador principal (publicação) Posição no pipeline: meio da cadeia

Formata o artigo conforme o modelo do veículo e monta o pacote de submissão — materiais suplementares, declaração de disponibilidade de dados / código, carta de apresentação, declarações de ética e de conflito de interesse — mais um plano de preprint / arquivamento com um DOI e uma lista de verificação de submissão. O operador submete o pacote; o sucessor terminal é /research-disseminate, que leva o trabalho publicado ao seu público.

Invocação canônica

/research-publish

Com argumentos:

/research-publish [--suite-name NAME]

Entradas

O entregável do artigo e o _outputs/review-report.md (as revisões da revisão por pares e sua lista de não julgados).

Saídas

O pacote de submissão formatado para o veículo em um local natural do host (o manuscrito formatado + materiais suplementares + declaração de disponibilidade de dados / código + carta de apresentação + declarações de ética / conflito de interesse) + _outputs/publication-record.md (incluindo o registro datado de regras do veículo: cada regra com sua página oficial de origem, a data de leitura e o estágio de submissão) + uma lista de verificação de submissão.

A jusante

/research-disseminate (consumidor a jusante) — o operador realiza a submissão e, em seguida, /research-disseminate leva o trabalho publicado ao seu público. Quando o veículo retorna revisões, execute novamente /research-review sobre o artigo revisado antes de remontar o pacote.

Fases do fluxo de trabalho

O comando segue o fluxo de trabalho padrão do pipeline /research:

  1. Carregar contexto — Ler o artigo e o relatório de revisão; fixar o veículo, o ciclo, a trilha e o tipo de artigo, e registrar cada regra do veículo com sua página oficial de origem, a data de leitura e o estágio de submissão.
  2. Verificar o Portão de sequência — Confirmar que _outputs/review-report.md existe e que as revisões de severidade HIGH dele estão resolvidas (ou que o operador aceitou explicitamente o risco residual); caso contrário, interromper com Blocked: run /research-review first.
  3. Formatar e empacotar — Carregar cada regra do veículo com sua página de origem, data de leitura e estágio de submissão, construir sobre o modelo intocado do veículo, contar páginas e palavras do jeito do veículo e inspecionar o PDF compilado; depois montar suplementar, disponibilidade de dados/código, carta de apresentação, declarações de ética / conflito de interesse.
  4. Planejar o preprint / arquivamento — Registrar o plano de preprint e DOI; construir a lista de verificação de submissão.
  5. Atualizar o manifesto de transferência — Registrar o pacote de submissão e o registro de publicação.
  6. Emitir o pacote — O pacote de submissão formatado para o veículo + _outputs/publication-record.md.

Piso de rigor

A formatação honra a divulgação em estágios: para um veículo de revisão duplo-cega, autor, instituição e identidade do sistema são removidos para metadados submetidos separadamente e restaurados somente no estágio designado de versão final. O depósito de arquivamento carrega o pacote de evidências de reprodutibilidade escalonado ao veículo (dados, código, ambiente fixado, sementes, registro de hardware, resultados por instância e figuras). Para um veículo duplo-cego, o arquivo suplementar e todo repositório ou conjunto de dados vinculado são inspecionados quanto à identidade, não apenas o manuscrito.

As regras do veículo têm fonte e estágio. Somente as páginas oficiais do próprio alvo contam: um veículo vizinho, um ciclo anterior ou uma trilha irmã nunca serve de substituto, e uma remontagem para uma revisão ou para a versão final aplica os limites desse estágio, não os da submissão inicial. Uma regra sem página oficial por trás é perguntada ao operador e marcada como não verificada junto ao veículo. Os arquivos de modelo do veículo permanecem como foram emitidos, de modo que um arquivo inicial escrito localmente é relatado como tal. Páginas e palavras são contadas do jeito do veículo, com as seções excluídas registradas, e cada figura e tabela é verificada no tamanho e no formato que o veículo recebe.

Modos de falha

SintomaCausaRecuperação
Blocked: run /research-review firstNenhum relatório de revisão, ou revisões HIGH em abertoExecute /research-review para produzir _outputs/review-report.md, ou resolva as revisões HIGH em aberto e execute /research-review novamente, ou aceite explicitamente o risco residual
Revisão HIGH não atendidaAchado de revisão ignoradoAtenda à revisão e execute /research-review novamente
Falta disponibilidade de dados/códigoSuperfície de reprodutibilidade ausenteAdicione a declaração de disponibilidade de dados / código antes da submissão
Regra do veículo sem fonteA regra vem de outro ciclo, trilha ou veículo vizinho, ou da memóriaFixe o alvo; registre a página oficial, a data de leitura e o estágio da regra, ou pergunte ao operador e marque-a como não verificada
Modelo alteradoUma edição local altera a geometria de página ou as configurações tipográficas do veículoRestaure os arquivos do veículo e altere o leiaute somente por meio de opções que o modelo documenta

Exemplos

# Montar o pacote de submissão do veículo
/research-publish --suite-name <name>

Referências cruzadas

On this page