Yacs handbook Authoring

How to post by e-mail?

Prepare a message using your preferred mail software, be it Mozilla, Lotus Notes, Microsoft Outlook, or another one.

Actually any software able to send a plain text message is ok, including mail robots that generate messages automatically.

Of course you will have to send the message to the adequate recipient address. On reception, some YACS server will process the message as if it were some text coming from the usual web form.

Well, actually YACS will almost mimic the web form. Some steps of the publishing process are specific to the e-mail interface.

For example, fields featured separately at the on-line form will have to be combined into a single electronic message. Also, the handling of attached files is different.

If you send a basic message to YACS, its title and content will become the title and content of the created article. But if you want to take the most out of this, there are a number of options to consider.

[title]How will I know the message has been posted?[/title] When YACS transforms messages to posts it also sends feed-back messages to posters.

Therefore, if you send an e-mail to your blog and have no reply, it is likely that your message is stucked somewhere.

Or maybe the feed-back feature has been disabled. This will be the case for queues also plugged into mailing lists.

[title]How to introduce your post?[/title] To add an introduction to your article you can either use the <introduction> tag, or put it on a single line.

The single line syntax is quite straightforward. Type the keyword introduction:, followed by a space and by a piece of text.

Example:
introduction: This is an introduction to my new blog.

This is the beginning of the blog body.


Use the tag either if the introduction has several lines, or if you are an afficionado of the XML-syntax

Example:
<introduction>
This is an introduction to my new blog.
</introduction>
This is the beginning of the blog body.


[title]How to attach files?[/title] YACS handles correctly most multipart messages. This means that if you attach files and images to your message, they will be correctly attached to the target page.

More precisely, attached images will be embedded in the page body, while other attachments will be listed at the end of the page.

[title]How to add bells and whistles?[/title] Generally speaking you cannot put HTML tags into a plain text message. You can, however, use YACS codes where applicable.

For example, you can use [b] and [/b] for bold, and [i]...[/i] for italics.

You may also want to use other YACS codes to structure your page with quotes, lists, tables or titles and subtitles.

Actually all YACS codes can be used in e-mailed posts, and the two minutes you will take to check help pages on this topic will probably save you a lot of time in the future.

[title]How to change the blog used?[/title] Each mail queue can be assigned separately to a preferred blog. This blog will be used for all posts with no specific blogging target.

You may override this setting when preparing your post by specifying explicitly the section or blog to use.

You can either use the <section> or <blog> tag, or put it on a single line.

The single line syntax is quite straightforward. Type the keyword section: or blog:, followed by a space and by a section id or nickname.

Example:
section: ideas

This is a very clever idea I am proud of.


The tag may be placed anywhere in your message.

Example:
This is a very clever idea I am proud of.
<section>ideas</section>


Obviously you will have to know the id of the blog to use. If you don't remember numbers, set a nickname to your blog and use it instead, like in samples above.

[title]How to categorize your post?[/title] Well, you are the kind of person who likes to put everything at the right place, aren't you? Good news, YACS has a tag to help you list categories.

Example:
<categories>PHP, MySQL, Apache, interesting subjects</categories>


[title]Can you show me an example of all this?[/title]

Sure, here is a sample message showing almost all points discussed previously:

<section>ideas</section>
<categories>PHP, MySQL, Apache, interesting subjects</categories>
<introduction>
This is an introduction to my new blog.
</introduction>
[toc]
This is the beginning of the blog body.
As you can see some text is in [b]bold[/b]
and other is in [i]italics[/i]

[title]First level title[/title]
Titles will be put automatically into the
table of content at the top of the page body.

[title]Other title[/title]
Additional text