Help:Editing

Revision as of 20:53, 6 May 2010 by Jorge Grante (talk | contribs) (PHP syntax higlighting)

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.7. Up-to-date documentation for the latest stable version of Moodle may be available here: Editing.


This page is for editing Moodle Documentation (MoodleDocs). This is a similar but much more robust type of program than the standard Moodle wiki.

Edit tab

Every MoodleDoc page has an "edit" tab at the top . This link will let you edit the page you are viewing. Please try editing a page by using this sandbox link. We will cover more formatting and special MoodleDoc features below. The edit tool bar is easy to use.

Edit tool bar

Hold the mouse cursor over the edit tool bar to see what functions each icon will do. From left to right: Bold, Italics, Internal (page) link, external link, Level 2 heading, embedded image, media file link, mathematical formula, no wiki, signature and time stamp, horizontal line.

Show preview

In edit mode, the show preview button at the bottom of the page lets you see what the page will look like after your edit, before you actually save. We all make mistakes; this feature lets you catch them immediately. Using Show preview before saving also lets you try format changes and other edits without cluttering up the page history, and has a number of other advantages. Don't forget to save your edits after previewing, though!

Edit summary

Before saving the page, it's considered good practice to enter a very brief summary of your changes in the summary box below the edit-box.

Formatting

Most formatting in MoodleDocs is usually done with MediaWiki markup - you don't have to learn HTML!

Bold and italics

Bolding and italicizing is done by surrounding a word or phrase with multiple apostrophes ('):

''italics''
appears as italics. (2 apostrophes on both sides)
'''bold'''
appears as bold. (3 apostrophes on both sides)
'''''bolded italics'''''
appears as bolded italics. (5 apostrophes on both sides)

Headings and subheadings

Headings and subheadings are an easy way to improve the organization of an article.

Headings can be created like this:

==Top level heading==
(2 equals signs)
===Subheading===
(3 equals signs)
====Another level down====
(4 equals signs)

If an article has at least four headings, a table of contents will automatically be generated.

Indentations

The simplest way of indenting is to place a colon (
:
) at the beginning of a line. The more colons you put, the further indented the text will be. A newline marks the end of the indented paragraph e.g.
This is aligned all the way to the left.
:This is indented slightly.
::This is indented more.

is shown as

This is aligned all the way to the left.
This is indented slightly.
This is indented more.

Lists

What it looks like What you type
  • Unordered lists are easy to do:
    • start every line with a star
      • more stars means deeper levels
  • A newline
  • in a list

marks the end of the list.

* Unordered Lists are easy to do:
** start every line with a star
*** more stars means deeper levels
*A newline
*in a list  
marks the end of the list.
  1. Numbered lists are also good
    1. very organized
    2. easy to follow
  2. A newline
  3. in a list

marks the end of the list.

# Numbered lists are also good
## very organized
## easy to follow
#A newline
#in a list  
marks the end of the list.
Descriptive lists:
first tag 
accompanying description
second tag 
more description
third tag 
surprise! more description
Descriptive lists:
; first tag : accompanying description
; second tag : more description
; third tag : surprise! more description

Preserving formatting

What it looks like What you type

Leading spaces are another way to preserve formatting.

Putting a space at the beginning of each line
stops the text from being reformatted. 
Leading spaces are another way to preserve formatting.

 Putting a space at the beginning of each line
 stops the text from being reformatted.

You can also use <pre> tags.

A "nowiki" tag on either side of text area, starts and stops wiki formatting within a line of text. For example, placing the tags here <nowiki> turns off linking [[Main Page]] </nowiki> and then starts the wiki formatting again. Here is the same link Main Page without the tags on either side.

The HTML edit tool bar has a nowiki icon.

=== === Destacá PHP sintaxe

(Class = | "nicetable" | - ! Que parece ! O que você digita | - | $ user = $ DB-> get_record ('user',> array ('id' => '1');</ código

|
 <code <nowiki> Php> $ user = $ DB-> get_record ('user', array ('id' => código '1');</> </ nowiki> </ pre>
|)

Tabelas === ===

Veja # Spreadsheet_to_wiki_table_format fazer Ajuda Mediawiki Pará Detalhes completos Sobre a tabela da Sintaxe.

(Classe = | "nicetable"
| -
! Que Parece
! O Que VOCÊ digita
| -
| A tabela:

(Classe = | "nicetable"
| -
! pai
! Mae
! Filho
| -
| 1
| 2
| 3
| -
| 4
| 5
| 6
|)

| <pre> <nowiki> Tabela A:

(Classe = | "nicetable"
| -
! Pai
! Mae
! FILHA
| -
| 10, uma célula
| 20, célula2
| 30, Célula 3
| -
| 40, UM celular
| 50, Célula 2
| 60, Célula 3
|)
</ Nowiki> </ pre>
|)

Note, a class = "nicetable" É o Nosso MoodleDocs CORTAR local para. Voce PoDE Deixa-lo par conseguir Uma mesa Sem Fronteiras.

Links e Âncoras == ==
Links para outras páginas são o coração de um wiki e MoodleDocs.

=== === Links Page
Para fazer um link da página wiki, basta colocar a palavra entre colchetes duplos, como este: <code> <nowiki> Sandbox </ nowiki> </ code>. Destaque de texto e usando o link "interno" ferramenta vai fazer isso também.

Se você quiser usar outras palavras que o título do artigo, o texto do link, você pode fazer isso adicionando o pipe "divisor" | seguido por um nome alternativo ou texto.

Por exemplo, se você quiser fazer um link para o Sandbox, mas queria dizer "meu texto", você poderia escrever como: <code> <nowiki>  meu texto </ nowiki Código >...</> Parece como:  meu texto ... mas a ligação com o sandbox.

Há algumas notações especiais ligação interna. Por exemplo <nowiki> # top </ nowiki> sempre ir para o topo da página atual.

=== === Ligações externas

A maneira mais fácil para fazer uma ligação externa é simplesmente digite a URL completa da página que deseja vincular, por exemplo, http://moodle.com.

Para fazer o link mostrar algo diferente da URL, use um colchete em cada extremidade. Se você quiser fazer um link para moodle.com, tipo <code> <nowiki> [1] </ nowiki> </ code>
Isto irá exibir o link de um número entre colchetes, assim:] http://moodle.com/ [. Há também a ferramenta de link externo, que também pode ajudá-lo.

Se quiser que o link apareça com o texto que você especificar, adicionar um título alternativo após o endereço separados por um'espaço "(nãode um tubo). Então, se você quiser que o link apareça como Moodle, basta digitar <code> <nowiki> Moodle </ nowiki> </ code>.

=== === Links Video
Com o advento do YouTube, Google Video, e uma série de outros sites, é muito útil para ser capaz de ligar diretamente para o vídeo do Moodle. Tudo que você precisa fazer é fornecer a URL do vídeo, em qualquer área de construção de HTML no Moodle, tais como "adicionar um recurso" ou "Adicionar uma actividade" área. Basta clicar no ícone do hiperlink e digite a URL do vídeo, ou cole a URL do site de vídeos menu URL. Você pode querer experimentar este link para ver o vídeo:] http://www.youtube.com/watch?v=4xjXelUZguw [

Você notará uma caixa de menu ao lado do vídeo que contém uma URL e e código Embed. Você pode copiar a URL na caixa de menu, ou você pode até mesmo fornecer as informações para encaixar o vídeo copiando o código e inseri-la em sua página Moodle.

Categorias === === Links
A categoria é um tipo de página de índice, uma página de links listados em ordem alfabética. No modo de exibição de página, uma lista de categorias que uma página é ligado, aparece na parte inferior.

Paracolocar uma página em uma categoria, basta digitar <code> <nowiki> [[Category :]]</ nowiki> </ code>, e colocar o nome da categoria entre os dois pontos e os suportes .

Para link'diretamente para acategoria "uso <code> <nowiki> [[ Categoria: Professor professor |]] </ nowiki> </ code>, isto vai mostrar como  , nota o "anterior", que é diferente para <code> <nowiki> [[Categoria: Professores dos professores |]] </ nowiki> </ code>. O segundo vai colocar a página atual na categoria professor como mencionado acima.

Se você colocar uma página em uma categoria, é geralmente uma boa idéia'adicionar umaespécie-chave "para a categoria da seguinte forma: <code> <nowiki>  Eclipse </ nowiki> </ code>. Isto irá resultar na página que está sendo colocada sob "E" como "Eclipse" na lista de link por ordem alfabética, onde a maioria dos usuários vai olhar para ele.

Você também pode usarMediaWikivariável PAGENAME '(= o título do artigo, sem o seu espaço) como uma espécie-chave: <code> <nowiki>  (PAGENAME }</ nowiki> </ > código.

Esta página está relacionada com a categoria single "MoodleDocs".

Links Inter-language

Basta digitar <code> <nowiki> </ nowiki> </ code no Moodle Docs Inglês ou <nowiki> <code> [[en: Correspondente página em Inglês] ] </ nowiki> </ code> na espanhol Moodle Docs, na parte inferior da página, abaixo do link da categoria. Inter-relações linguísticas aparecerão automaticamente no "Em outras línguas" bloco.

Se por algum motivo você quer se referir a uma página em outra versão de idioma no texto correndo, preceda o código da linguagem por uma vírgula. Assim, a referência feita no parágrafo anterior foi produzido pelo texto <nowiki> espanhol Moodle Docs </ nowiki>.

Usuário links de página

Os nomes de usuário pode ser ligado a uma página de usuário. Por exemplo <nowiki> Helen Foster </ nowiki> aparece Helen Foster e link para a página do usuário. Comentários dos outros usuários são geralmente deixados na guia de usuário comentário página.

=== === Links Interwiki [TODO]

=== === Âncoras Manual Excepto âncoras automatizada ( veja abaixo) âncoras manual pode ser inserido usando algo que esta presente:

 <nowiki> My Anchor .</ span> </ nowiki>

Que, se implementada, criar uma âncora id="anchor_one"> <spanMy Anchor span> .</.

Dentro da página agora posso referir a este link como link para minha âncora, usando o seguinte:

 <nowiki> link para minha âncora </ nowiki>

Se você quiser ter um link de volta para o topo de uma (longa) página, basta inserir:

 <nowiki> Voltar ao topo da página </ nowiki>

Comentários Page

O separador comentário página é utilizada para a discussão sobre a página. Às vezes, antes de fazer uma edição na página pela primeira vez, é uma boa idéia para verificar os comentários da página. Ela pode ser formatada a mesma como uma página principal, assim pode ser usado para mostrar um projecto de proposta de mudança.

contribuições página de discussão podem ser assinados e datados, escrevendo quatro tiles <nowiki> ~~~~</ nowiki>. Isso será exibido como Helen Foster 06:35, 19 de fevereiro de 2006 (WST), por exemplo.

Há também um botão útil para assinatura na barra de ferramentas do campo de edição: Imagem: Signature icon.png

Histórico

O guia histórico da página permite um modo de olhar para mudanças entre diferentes edições. Também é possível reverter (roll back) a editar uma versão anterior. Normalmente, isso é deixado ao administrador, mas você certamente pode reverter o seu edições recentes.

Assista e Unwatch página

A página assistiu aparecerá em "Artigos vigiados", quando sempre alguém edita a página. Há um guia ao lado da história que funciona como uma alternância entre o relógio eo Unwatch. Há também, na parte inferior da página no modo de edição de um relógio "esta página" check off caixa.

Ver também

Categoria: MoodleDocs [Ja [: Ajuda: 编 集 方法]]