author | Dan Fuhry <dan@enanocms.org> |
Sun, 18 Sep 2011 02:13:34 -0400 | |
changeset 1354 | eecde44145eb |
parent 1104 | 299d7e6e328b |
permissions | -rw-r--r-- |
1097 | 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. |
2 |
||
3 |
=== Your first edit === |
|
4 |
||
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 (<!-- like this -->) 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! |
|
6 |
||
7 |
==== User-entered text ==== |
|
8 |
||
9 |
<!-- Put your own text below this line! --> |
|
10 |
||
11 |
<!-- Put your own text above this line! --> |
|
12 |
||
13 |
=== Create your first page === |
|
14 |
||
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 | 17 |
=== Add some flair === |
18 |
||
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. |
|
20 |
||
21 |
To use bold text: |
|
22 |
||
23 |
<code><nowiki>'''Your text here'''</nowiki></code> |
|
24 |
||
25 |
To use italic text: |
|
26 |
||
27 |
<code><nowiki>''Your text here''</nowiki></code> |
|
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 | 30 |
|
31 |
<code><nowiki>[[Page title]]</nowiki></code> |
|
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 | 35 |
<code><nowiki>[[Page title|Your text here]]</nowiki></code> |
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 | 41 |
Create a large heading: |
42 |
||
43 |
<code><nowiki>== Your text here ==</nowiki></code> |
|
44 |
||
45 |
Create a medium heading: |
|
46 |
||
47 |
<code><nowiki>=== Your text here ===</nowiki></code> |
|
48 |
||
49 |
Create a small heading: |
|
50 |
||
51 |
<code><nowiki>==== Your text here ====</nowiki></code> |
|
52 |
||
53 |
== Visual editing == |
|
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 | 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 | 61 |
== Moving up from Enano 1.0? == |
62 |
||
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. |
|
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 | 66 |
|
67 |
== All done! == |
|
68 |
||
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. |
|
70 |
||
71 |
[[Basic_administration|Next step: Basic administation »]] |