Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.1 - Português

Change language to:
English - Français - 日本語 - Русский

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Ajuda do Scilab >> Gerenciamento de ajuda online > utilities > help_from_sci

help_from_sci

Geração de arquivos de ajuda e de arquivos de demonstração a partir da seção de comentários de cabeçalho de um arquivo-fonte .sci

Seqüência de Chamamento

help_from_sci() // gera um modelo de função vazio
help_from_sci(funname,helpdir) // gera helpdir/funname.xml a partir de funname.sci
help_from_sci(dirname,helpdir) // processa dirname/*.sci e cria helpdir/*.xml.
help_from_sci(dirname,helpdir,helpdir) // como acima, mas também cria o arquivo de demonstração helpdir/*.dem.sce.
[helptxt,demotxt]=help_from_sci(funname) // retorna funname.xml e funname.dem.sce como duas matrizes de texto.

Parâmetros

funname:

o nome de um único arquivo .sci a ser processado

dirname:

nome do diretório onde todos os arquivos .sci serão processados

helpdir:

endereço opcional onde o arquivo de ajuda .xml será criado

demodir:

endereço opcional onde os arquivos de demonstração .dem.sce serão criados baseados nos códigos da seção Examples

helptxt:

retorna o código da ajuda XML se helpdir for vazio, ou o endereço para o novo arquivo .xml

demotxt:

retorna o código de demonstração se demodir for vazio, ou o endereço para o novo arquivo .dem.sc

Descrição

help_from_sci é uma versão revisada da função help_skeleton. Seu objetivo é gerar arquivos de ajuda .xml baseados na seção de comentários de cabeçalho dos arquivos-fontes .sci. Opcionalmente, os arquivos de demonstração .dem.sce podem ser gerados baseados nos códigos da seção Examples na seção de cometários de cabeçalho dos arquivos .sci.

Para que help_from_sci formate o arquivo .xml propriamente, os a seção de comentários de cabeçalho deve concordar com algumas regras simples de formatação.

A primeira linha de comentário seguinte à definição de função deve conter uma descrição breve da função.

Os comentários restantes são formatados de acordo com os seguintes cabeçalhos (opcionais): "Syntax", "Parameters", "Description", "Examples", "See also", "Used functions", "Authors" e "Bibliography".

As seguintes diretrizes devem ser seguidas ao se escrever os comentários de código fonte:

  • Syntax - um exemplo por linha.

  • Parameters - separe o nome do parâmetro e a descrição por um ":". Mantenha a descrição de cada parâmetro na mesma linha.

  • Description - a formatação do texto pode ser feita utilizando comandos XML. Adicionar uma linha de comentário vazia na seção Description é interpretado como começo de um novo parágrafo.

  • See also - liste um nome de função por linha.

  • Authors - escreva um autor em cada linha após o cabeçalho Authors. Use ";" para separar os autores de qualquer informação adicional.

  • Bibliography - escreva uma referência por linha seguindo o cabeçalho References.

The "&" character as well as numerical HTML entities like "{" are supported in the contents. Literal HTML entities like "´" are not accepted. Please use directly the UTF-8 character like "é" instead.

Exemplos

help_from_sci()   // abrindo um modelo de código-fonte vazio no editor.
// salve este modelo como test_fun.sci no diretório corrente antes de executar
// os próximos comandos do exemplo

help_from_sci('test_fun')        // retornando o esqueleto xml como um string de texto.

help_from_sci('test_fun','.')    // criando o arquivo de ajuda xml no diretório corrente.

// criando ambos os arquivos de ajuda e demonstração no diretório corrente.
help_from_sci('test_fun','.','.')

// de um diretório raiz de um toolbox, uma seqüência de chamamento típica seria:
// help_from_sci('macros','help\pt_BR','demos')
// este comando processaria todos os arquivos .sci no diretório de macros
// e utilizaria a seção de comentários de cabeçalho para atualizar as ajudas .xml no
// diretório help\en_US e reconstruiria os arquivos .dem.sce no diretório demos\.

Ver Também

  • help — queries and displays help pages in the Scilab help browser
  • help_skeleton — constrói o esqueleto do arquivo de ajuda xml associado à função Scilab
  • xmltohtml — converte arquivos de ajuda xml do Scilab para formato HTML

Histórico

VersãoDescrição
6.0.1 Numerical HTML entities like ω are now accepted in heading comments. However, writting directly UTF-8 characters should be preferred.
Report an issue
<< del_help_chapter utilities help_skeleton >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jan 03 14:35:43 CET 2022