Snippets

O SMath Studio tem um mecanismo integrado para expandir as suas funcionalidades através da criação de snippets de utilizador. Estes snippets são criados a partir de cálculos comuns e, quando necessário, incorporados noutros cálculos, o que permite aos utilizadores reutilizar muitas vezes uma lógica já preparada.

Criar um snippet

Um snippet baseia-se num cálculo comum preparado no SMath Studio. Para criar um snippet, siga estes passos:

1. Crie um novo cálculo no SMath Studio.
2. No cálculo criado, adicione uma função ou um procedimento personalizados e defina as variáveis ou unidades de medida a que pretende dar acesso.
3. Depois de o cálculo estar preenchido com a lógica, defina os seus metadados; para isso, abra a caixa de diálogo Arquivo > Propriedades....
4. No separador Summary da caixa de diálogo File Properties, preencha pelo menos os campos Title, Author e Description.
5. No separador Atributos do arquivo da caixa de diálogo Propriedades do arquivo, preencha o campo Atalho para fragmento de informação, que ajudará a inserir rapidamente o snippet em cálculos futuros. Recomendamos um texto único e curto para o atalho, sem espaços nem carateres especiais. Como exemplo, pode ver os snippets integrados no SMath Studio, como grads e degrees.
6. Guarde o cálculo resultante localmente e mova-o para a seguinte pasta do seu PC: %APPDATA%\SMath\extensions\snippets

Após estes passos, o snippet ficará disponível para utilização local.

Utilizar um snippet

Há duas formas de inserir os snippets disponíveis num cálculo:

1. Através da lista de sugestões da introdução dinâmica: Na página do cálculo, comece a escrever o atalho do snippet e utilize a lista pendente para selecionar o pretendido (a seleção final pode ser feita com o rato ou com o teclado, seguindo as sugestões):
2. Através do Gerenciador de extensões integrado no SMath Studio. Na caixa de diálogo que se abre, selecione Blocos de código na lista do lado esquerdo para mostrar todos os snippets disponíveis localmente. Em seguida, selecione o snippet pretendido e clique no botão Inserir.

Publicar um snippet

A publicação do seu snippet no Root Licensing Server, para acesso gratuito por terceiros, é opcional.

Para que o seu snippet passe a fazer parte do processo padrão de distribuição a outros utilizadores, siga estes passos:

1. Aceda ao Root Licensing Server e certifique-se de que tem sessão iniciada com a sua conta.
2. Aceda à página de registo de extensões.
3. No formulário de registo, selecione Extension type: Snippet, indique o caminho para o ficheiro do snippet e clique no botão Register.