O editor HTML de documentação

Apresentação

O editor gráfico HML implementa as únicas funções necessárias à redação de um parágrafo da documentação ou a um parágrafo de ajuda em linha, não produz uma página HTML completa.

Resta possível de ultrapassar as capacidades de editor gráfico em intervindo directamente na fonte HTML, mas a utilização da função de limpeza pode então suprimir os limites não autorizados acrescentados desta maneira.

Atenção: É imperativo de sair do editor gráfico após ter efectuado uma modificação afim de desacinzentar o botão da função Documentação e de registar sobre o servidor da ficha modificada.

Îcones, botões e atalhos teclado

Îcones da faixa

Icône	Função	Exemplos:
	Criação de um parágrafo	Texto :
	Criação de um título	Texto :
	Criação de um sub-título	Texto :
	Texto cinzento ou normal	Texto :
	Texto cinzento ou normal	Texto :
	Texto sublinhado ou normal	Texto :
	Alinhamento esquerda	Texto :
	Alinhamento centro	Texto :
	Justificação	Texto :
	Alinhamento direito	Texto :
	> Lista :	Texto 1 Texto 2
	Deslocação direita	Texto :
	Anulação de uma acção deslocamento à direita	Texto :
	Criação de uma relação hipertexto.	Texto :
	Imagem
	Botão
	Quadro	Texto 1 Texto 2 Texto 3 Texto 4
	Limpeza selectiva do HTML
	Afixação e modificação da fonte HTML
	Alerta indicando um problema no html. Permite de visualizar e de modificar o código html do produto.

Botões de caixa de diálogo

	Registar
	Anular

Principais atalhos do teclado

Enter	Criação de um parágrafo
Shift/Enter	Criação de uma nova linha.
Ctrl/c	Copier
Ctrl/v	Colar
Ctrl/x	Suprimir
Ctrl/a	Seleccionar todos os elementos
Ctrl/z	Anula a acção precedente
Duplo clique	segundo objecto

Gestão das listas

Criar uma lista simples

Apoiar sobre o îcone lista e registar o texto. Apoiar sobre a tecla "enter" para registar uma segunda linha ou duas vezes sobre a tecla "enter" para sair da lista.

• Linha 1
• Linha 2

Para registar várias linhas de texto ao nível de uma única linha da lista apoiar simulataneamente sobre as teclas "shift" e "enter" para criar as linhas seguintes.

• Linha 1
• Linha 2
  Linha 2-1

Criar uma lista a vários níveis

Criar uma lista simples depois seleccionar as linhas a modificar e apoiar sobre Îcone deslocamento direito tanto de vezes que se deseja "descender" nos níveis, o îcone deslocação esquerda permite de efectuar a operação inversa.
Apenas os dois primeiros níveis são simbolizados por ""bullets"".

• Linha 1
• Linha 2
  Linha 2-1
• Linha 3 nível 2
• Linha 4 nível 2
• Linha 5 nível
  Linha 5-1 nível 3
• Linha 6 nível
  Linha 6-1 nível 4
• Linha 7

As relações hipertexto

Criação

Seleccionar um texto ou uma imagem depois apoiar sobre o îcone. Na caixa de diálogo registar URL localizando a página e se for caso disso a âncora destino (o URL deve ser relativo à página em curso de redacção). Validar.

Modificação

Posicionar o cursor sobre o texto ligação e apoiar sobre o îcone relação ou duplo-clicar sobre a relação. A caixa de diálodo aparece com o valor da relação. Modificar a relação e validar.

Supressão

Posicionar o cursor sobre o texto relação e se apoiar sobre o îcone relação. A caixa de diálogo aparece com o valor da relação. Suprimir a URL e validar.

Gestão das imagens

Criação

Deve-se notar que, no editor de documentação, as imagens são normalmente estocados na base como os documentos juntos.

A imagem aparece sob a forma seguinte:

Ele pode ser redimensionado pelos puxadores.

Modificação

Supressão

Gestão dos botões

Criação

Posicionar o cursor ao sítio de inserção do botão depois apoiar sobre o îcone botão. Duplo-clicar sobre o botão criado para registar o literal do botão.

Modificação

Duplo-clicar sobre o botão criado para registar o literal.

Supressão

Seleccionar o botão e apoiar sobre a tecla "Delete" ou CTRL/X

Gestão dos quadros

Criação

Posicionar o cursor ao sítio de inserção do quadro depois apoiar sobre o îcone quadro. Registar o número de colunas, o número de linhas, o tamanho em pixeis das bordas (0 se sem bordure) e escolher se a primeira linha do quadro é uma linha de vcabeçalho

Exemplo:

Quadro sem cabeçalho

Quadro com cabeçalho

Modificação

Seleccionar o quadro de maneira a fazer aparecer os puxadores depois clicar sobre o îcone quadro efectuar as modificações depois validar.
Em caso de modificação do número de linhas ou do número de colunas são linhas e colunas em fim de quadro que serão afectados.
Quando um quadro sem cabeçalho está modificado em quadro com cabeçalho, é necessário de intervir sobre cada contaúdo da primeira linha para passar a negrito cada elemento, a operação inversa é a fazer quando um quadro com cabeçalho está passado sem cabeçalho.
As tabulações permitindo de passar de uma célula ao seguinte e de inserir uma linha em fim de quadro. 
Um quadro pode ser redimensionado pelos puxadores.

Supressão

Seleccionar o quadro de maneira a fazer aparecer os puxadores (clique sobre uma borda) e apoiar sobre "Delete" ou CTRL/X.

Limpeza do código HTML

Esta função permite de suprimir as balisas html não autorizadas. Ela deve ser utilizada nomeadamente após copiar/colar de um texto a partir de uma documentação existente.

As balizas HTML autorizados

Exemplo de limpeza

O código html seguinte

<DIV class=Section1>
<H4><SPAN style="text-shadow: none">Texte 1<?xml:namespace prefix = o /><o:p></o:p></SPAN></H4>
<P class=MsoBodyText>Texte 2.</P>
<P class=MsoBodyText>Texte 2</P>
<H5><SPAN style="text-shadow: none">Texte 4<o:p></o:p></SPAN></H5>
<P class=MsoBodyText>Text 5</P>
<P class=MsoBodyText><?xml:namespace prefix = v /><v:shapetype id=_x0000_t75 stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"></v:path><o:lock aspectratio="t" v:ext="edit"></o:lock></v:shapetype><v:shape id=_x0000_i1025 style="WIDTH: 382.5pt; HEIGHT: 136.5pt" o:ole="" type="#_x0000_t75"><v:imagedata o:title="" src="./Listes%20de%20picking_fichiers/image001.png"></v:imagedata></v:shape></P>
<P class=MsoBodyText><v:shape id=_x0000_i1026 style="WIDTH: 218.037,60cm³; HEIGHT: 138pt" o:ole="" type="#_x0000_t75"><v:imagedata o:title="" src="./Listes%20de%20picking_fichiers/image003.png"></v:imagedata></v:shape></P>
<P class=MsoBodyText>&nbsp;<o:p></o:p></P>
</DIV>

será

<H4>Texte 1</H4>
<P class="">Texte 2.</P>
<P class="">Texte 2</P>
<H5>Texte 4</H5>
<P class="">Text 5</P>
<P class=""></P>
<P class=""></P>
<P class="">&nbsp;</P>

Atenção

Não há retorno atrás por Ctrl/z possível sobre esta encomenda.
A encomenda limpeza suprime As .

Editor textual

O editor permite de visualizar e editar a fonte HTML O texto e as balizas modificados vêm substituir o texto e as balizas HTML do editor gráfico no momento de registo (botão ).

Todos os limites registados no editor textual não fazendo por parte da lista dos limites autorizados são expurgados pela função de limpeza. Se esta função não é utilizada, os limites não autorizados enriquecerão a documentação gerada final.

Pode-se ocasionalmente constatar no editor textual a presença de URL não conformes nos atributos src ou href. É inútil de as modificar, serão normalizadas no momento da remonta dos dados versus o servidor.