language/english/install/default-tutorial/Creating_and_editing_pages.txt
author Dan Fuhry <dan@enanocms.org>
Sun, 18 Sep 2011 02:13:34 -0400
changeset 1354 eecde44145eb
parent 1104 299d7e6e328b
permissions -rw-r--r--
Improvements and updates to tutorial
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     1
At its heart, Enano is a wiki. Why is this special? Because content is at the heart of the Enano design, not an afterthought. In Enano, editing - like most other tasks - is done right on the page. The page is updated live so you can see your changes right away. You can edit a page simply by clicking the "Edit this page" button on the shiny black toolbar. Create a page simply by editing it - the first time you save it, it will be created automatically.
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     2
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     3
=== Your first edit ===
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     4
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     5
Let's try some basic editing now. Click the "edit this page" button you see on the textual toolbar at the top of this page. Type between the two HTML comments (&lt;!-- like this --&gt;) you see in the text box (you might have to scroll down a bit). Click "Save Changes" - you should see what you typed show up right away!
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     6
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     7
==== User-entered text ====
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     8
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
     9
<!-- Put your own text below this line! -->
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    10
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    11
<!-- Put your own text above this line! -->
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    12
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    13
=== Create your first page ===
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    14
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    15
Now let's try creating a page. Open [[My first page|this link]] in a new browser tab or window so that you can keep these instructions available. Click the same "edit this page" button and type some text. What you typed should be visible on the page now!
925
173aef60c13c Added the linked-to page of the tutorial (it is, however, a stub at this point)
Dan
parents:
diff changeset
    16
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    17
=== Add some flair ===
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    18
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    19
Have you noticed the way links and headings look on this page? They are embedded using a very simple language called ''wikitext''. You can use wikitext to organize and format your page, and to link to other pages. Linking to other pages is what makes a wiki, a wiki.
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    20
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    21
To use bold text:
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    22
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    23
<code><nowiki>'''Your text here'''</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    24
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    25
To use italic text:
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    26
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    27
<code><nowiki>''Your text here''</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    28
1104
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    29
Create an ''internal link'' to a page on your site:
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    30
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    31
<code><nowiki>[[Page title]]</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    32
1104
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    33
Create an internal link, but using your own text:
925
173aef60c13c Added the linked-to page of the tutorial (it is, however, a stub at this point)
Dan
parents:
diff changeset
    34
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    35
<code><nowiki>[[Page title|Your text here]]</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    36
1104
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    37
Link to an external site:
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    38
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    39
<code><nowiki>[http://www.example.com/ Your text here]</nowiki></code>
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    40
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    41
Create a large heading:
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    42
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    43
<code><nowiki>== Your text here ==</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    44
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    45
Create a medium heading:
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    46
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    47
<code><nowiki>=== Your text here ===</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    48
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    49
Create a small heading:
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    50
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    51
<code><nowiki>==== Your text here ====</nowiki></code>
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    52
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    53
== Visual editing ==
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    54
1354
eecde44145eb Improvements and updates to tutorial
Dan Fuhry <dan@enanocms.org>
parents: 1104
diff changeset
    55
If you prefer to design your documents in a more graphical way, you can use editor plugins such as [http://enanocms.org/plugins/tinymce TinyMCE] to edit your pages in a WYSIWYG (What-You-See-Is-What-You-Get) style. [[Basic administration#head:Install_a_plug-in|Install the plugin]] and then click the <a href="#" onclick="return false;" class="abutton abutton_blue image"><img width="16" height="16" src="images/spacer.gif" style="background-image: url(images/editor/sprite.png); background-repeat: no-repeat; background-position: -112px 0px;" /> Use another format</a> button in the editor.
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    56
1104
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    57
== Advanced wikitext ==
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    58
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    59
See [http://docs.enanocms.org/Help:Appendix_A Appendix A] in the Enano documentation for some more advanced wikitext formatting tips.
299d7e6e328b Tutorial: improved Creating & Editing page a little bit with respect to wiki formatting stuff
Dan
parents: 1097
diff changeset
    60
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    61
== Moving up from Enano 1.0? ==
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    62
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    63
Good news: You don't have to learn anything new to use Enano 1.2's formatting syntax or editor. We've improved the interface of the editor a lot though. Enano 1.2 also has new features like auto-saving and the ability to detect when someone else saves the page while you're working on it. Another new feature is a guard against automatically closing out the editor, so it's much harder to lose a page you're working on.
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    64
1354
eecde44145eb Improvements and updates to tutorial
Dan Fuhry <dan@enanocms.org>
parents: 1104
diff changeset
    65
The biggest change to page editing in Enano 1.2 is the way the renderer behaves when you use TinyMCE or another editor plugin to edit the page. We made this process a lot smarter so the wikitext engine doesn't try to apply formatting that should already be done by the plugin. This means, however, that you can't use certain bits of wikitext syntax - such as bold, italics, headings and tables - that are already covered through features of editor plugins.
1097
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    66
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    67
== All done! ==
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    68
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    69
That's it! Now you know how to write pages with Enano. Let's move on and learn how to do some basic administration of your new website.
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    70
4252e4d83102 A bit of work on tutorial content, more still needed
Dan
parents: 925
diff changeset
    71
[[Basic_administration|Next step: Basic administation &raquo;]]