jQuery History Plugin BBS

jQuery History Plugin BBS



RBBS Help

help
0
mikio
2004/10/19 05:25
2004/10/21 08:18

What is RBBS?

RBBS is a bulletin board system with Web interface. Users of RBBS can post new articles, and can attach responses to existing articles. As the principal purpose of RBBS is to be used as such communication system as BBS, it is useful for individual use and for one-to-many communication. The following are features of RBBS.

  • Accessibility : Articles are structured into chapters, paragraphs, and so on in the text with XML. The appearance of articles is defined with style sheet. Since document structure and presentation are separated, transmission of information corresponding to various needs in the Web environment is attained. Moreover, because Wiki-style format is supported, you can write and edit articles easily.
  • Floating Threads : When a response is attached to an article, the order of the article becomes the top of the page. Since articles to which responses are often attached are displayed in an exhibitionist manner, users can catch up popular topics easily. Moreover, because each response is only by one line, lighthearted communication like chat is taken.
  • Atom Syndication : In order for users to check new articles and responses easily, Atom feeds are delivered. Using a news reader supporting Atom, users can check some news site and RBBS at the same time.

Browsing Articles

When you access RBBS, you see the list of newcome articles from above of the page. That is, titles of newcome articles are shown in the order of creation (or modification) date. If you select a title, you see the content of the article.

Navigation links are placed below the newcome list. They have the following functions.

  • HOME : go to the home page of the site.
  • HELP : show the help page.
  • POST : post a new article.
  • FILE : manage files.
  • MEMO : show and edit the memorandum.
  • FEED : get the Atom feed.
  • LATEX : get the LaTeX data.
  • RELOAD : reload the page and show newcome articles.
  • SEARCH : search for articles.
  • LIST : show whole of the newcome list.
  • CAL : show calendar.
  • PREV : show the previous page.
  • NEXT : show the next page.

Texts of newcome articles are shown below the navigation links. Some navigation links are placed also in the shoulder of each article. They have the following functions.

  • EDIT : edit the content of the article. This is only for the administrator.
  • FEED : get the Atom feed of the single article.
  • LATEX : get the LaTeX data of the single article.
  • FOCUS : show all responses.
  • RESP : show the form to post a new response.

Posting an Article

In order to post a new article, select `POST' of the navigation links. Whereat, you move to the page to input the content of the article. As well, the password for writers is asked if the administrator have set the password to the site.

Next, input `Language', `Category', `Subject', `Author', and `Text'. In some cases, input `Password' for administration. Each line in the body text is treated as a paragraph. When inputting finishes , select `SUBMIT'.

Then, you move to the page to confirm the view of the article. `Source' specifies XML expression of the article. If you confirm it, select `SUBMIT' and the article is posted.

Each line in the body text is treated as a paragraph. However, if a line begins with `!', the line is treated as a topic. If a line begins with `!!', the line is treated as a subtopic. If a line begins with `*', the line is treated as a list item. If a line begins with `|', the line is treated as a pre-formatted text. To use a big pre-formatted text, place `===|' at the beggining and at the end. It is possible to modify a part of a line. If a line begins with `@graph:', the line is treated as a URL and it shows a graphic of the URL. If a line is `----', a ruled line is drawn. `[[^foo]]' makes `foo' an emphasized phrase. `[[~foo]]' makes `foo' a cited phrase. `[[+foo]]' makes `foo' an inserted phrase. `[[-foo]]' makes `foo' a deleted phrase. `[[foo|bar]]' makes `foo' a hyper link to `bar'. The following is an example. The following is an example.

!My Gourmet
I'm universally recognized as [[^a gourmet]].
If I pick up three of my favorite menus, I say the follwing.
*hashed rice : the decisive factor is rich beef
*pizza toast : accented [[-celery]][[+bell pepper]] is greatest
*broiled pig innards : take it with distilled spirit
!Logo of RBBS
I have made it.
@graph:http://rbbs.sourceforge.jp/logo.png
----
!Hello World
Here is the simplest program in C language.
!!sample 1
This code can be compiled with [[GCC|http://gcc.gnu.org/]].
|int main(int argc, char **argv){
|  printf("Hello, World\n");
|  return 0;
|}
!!sample 2
You should learn some control syntaxes.
===|
int i;
for(i = 0; i < 10; i++){
  printf("%d\n", i);
}
===|

The body text of an article can be structured with XML. If the text begins with `<', the text is treated as XML. The following blocks can appear in the body text of XML. As well, each line of the body text in plain text form is converted as a content of `para' element of XML.

  • <topic>...</topic> : the content is treated as a topic (equal to `h3' element of HTML).
  • <subtopic>...</subtopic> : the content is treated as a subtopic (equal to `h4' element of HTML).
  • <para>...</para> : the content is treated as a paragraph (equal to `p' element of HTML).
  • <asis>...</asis> : the content is treated as a pre-formatted text (equal to `pre' element of HTML).
  • <list>...</list> : the content is treated as an itemization block (equal to `ul' element of HTML). Child elements are expressed with some of `<item>...</item>' (equal to `li' element of HTML).
  • <graph data="***"/> : it is empty element. An image of the URL specified by the `data' attribute is embedded (equal to `img' element in `div' element of HTML).
  • <break/> : it is empty an element. A ruled line is drawn.

There can be the following modifications in the content of each block element and `item' element.

  • <link to="***">...</link> : the content is treated as a hyper link (equal to `a' element of HTML). The URL of the destination is specified by the `to' attribute.
  • <emp>...</emp> : the content is treated as an emphasized phrase (equal to `em' element of HTML).
  • <cite>...</cite> : the content is treated as a cited phrase (equal to `cite' element of HTML).
  • <ins>...</ins> : the content is treated as an inserted phrase (equal to `ins' element of HTML).
  • <del>...</del> : the content is treated as an deleted phrase (equal to `del' element of HTML).

An example of the XML text is shown below.

<topic>Breakfast</topic>
<para>Today's breakfast was ham and egg.  It was yummy.</para>
<list>
<item>ham and egg = 340 kcal.</item>
<item>croissant = 280 kcal.</item>
<item>coffee = 0 kcal.</item>
</list>
<topic>Lunch</topic>
<para>Today's lunch was <del>none</del><ins>Snickers</ins>.</para>
<topic>Dinner</topic>
<para>I had grilled beef at the dinner table.
<emp>Rib steak</emp> is the greatest.</para>
<topic>Today's Discovery</topic>
<para>I found <link to="http://qdbm.sourceforge.net/">QDBM</link>.
It's logo is not the greatest.</para>
<graph data="http://qdbm.sourceforge.net/logo.png"/>
<subtopic>Witticism</subtopic>
<para><cite>Happiness is a perfume...</cite> -- Emerson</para>
<break/>
<topic>Today's Hello, World</topic>
<asis>#include &lt;stdio.h&gt;

int main(int argc, char **argv){
  printf("Hello, World\n");
  return 0;
}
</asis>

Posting a Response

In order to attach a response to an article, select the `RESP' link. Whereat, the input form to write a response is shown. The left field is to specify the name of the author. The right field is to specify the body text. After inputting them, select `SUBMIT'. The article to which a new response have been attached is regarded as modified and its shown order become the top.

The body text of a response should be plain text and can not contain any line feed. If the body is empty but `SUBMIT' is selected, no response is written but the page is refreshed. If the name of the author begins with `sink:', the modification date of the article is not changed.

Atom Syndication

RBBS supports syndication of Atom 0.3. The two kinds of feed is available. The feed at the main navigation is for newcome articles. The feed at each article is for the article only.


Thu, 20 Jun 2013 05:16:29 +0900
Powered by RBBS 1.0.18.