How to Publish on this site
-- JacquesDaignault 2006-05-15 14:31:18
-- English Translation: ReneeFountain 2006-05-17 14:43:19 Version française
Contents
Preface
You want to see how the site works, what options there are (to simply comment or fully participate) in the IAACS site? Welcome! Here are a few conventions to follow to assure a minimum of cohesion. Note : These conventions apply to both the small and large contributions.
I am only a visitor, I do not wish to create an account
You are interested in the content but you are not interested in contributing. However, you would like to leave a comment, suggest an improvement or indicate an appreciation concerning the site simply click on the “Feedback” link (located on the right hand side of the page). Or, if the author of a given page has incorporated a "Comment" function you may comment their page directly. (The "Comment" box is typically located at the end of a wiki page.)
This is what the "Feedback/Comment” box looks like :
There is a box in which you can write your comments (or cut and paste from your text editor), a “Save” button, and 8 smileys from which you can choose 1. For the anonymous user, there are two small boxes, one for your signature and the other for your password 2 By default the system proposes the Internet Protocol (IP) address of the computer you are using as the signature and will generate a random password (which will be communicated to you immediately upon saving (this means sending) your comment. However, the BEST way for an anonymous user to manage (keep control over) their comments is to do fill in these two areas with the information (name and password) you will recall. (It is this information that you will need to undo any comment(s) you have made.) Again, if you are an IAACS participant (you have an account) and you are LONGED ON then this information will automatically be entered for you (It is your usual IAACS wiki name and password).
Here is an example:
What is written in red confirms that the comment was sent and a password has been generated for you. ( Attention, this password will disappear as soon as you leave this page so it is best to COPY IT DOWN somewhere! 3 NOTE : In addition to the signature and password the comment (message) you sent is also indicated. This is followed by the date (on the right) which is followed by a red “X” . This red X is the icon to click on if you wish to DELETE the comment. When you click on the red X a window will open asking for your password. If you decide to delete a comment a message will appear confirming that the comment has been deleted.
Thank you for your visit! Why not leave us a small souvenir by leaving comment or two?
I want to create an account
Follow these instructions!
What can I do on my personal page?
I did not really understand how to create my personal page
Follow these instructions!
Yes! I created my page!
Personal pages – the first of which is linked to a participants WikiName - is a place for you to present yourself. For example you can indicate contact information, your occupation, research interest, offer a few photos, etc.. You can also include any link you wish. For example you may wish to put a link to your web site or to your faculty. Or, you may wish to put some curricular links you find pertinent. You can also easily create links to other wiki pages on the IAACS site. ATTENTION ! To link to an existing IAACS page you need only retype its EXACT wiki name. For example, JacquesDaignault may want (if he is very, very smart husband) to put a link to his wife's wiki name!
You can create as many wiki pages as you like (For example, pages to present publications, texts, articles you are working on, interesting links ect.). However, we STRONGLY RECOMMEND that all the pages you create (associated with your personal page) be put into sub pages. SUB-PAGE.
These sub pages are just like any other wiki page except that they are all together, that is, under the same prefix. For example, participant (user) SusanChang would create a page that would house her publicaitns that would look like this : SusanChang/Publications. The system will transform it to look like this : SusanChang(2f)Publications 4. The / sign allows the creation of sub pages allowing you to keep track of and manage your pages. It also allows others to easily access your work. Moreover, this structuring is extremely valuable for site administrators (to know where all your pages are). You just never know when you will need our help
The last comment about sub pages. Try to : limit your hierarchies to three levels, and preferably to TWO levels.
Why? Just trust us, you do not want to have to learn the hard way about hierarchical limitations !
Just to be clear : SusanChang/Publications already has TWO hierarchies. The more / you add, the more complex your hierarchies will be. This may invite complications. So, keep your repertory names simple. You can create as many as you want, just keep each one short.
I want to create pages that are not linked to my personal page
The (new) IAACS site is not only a wiki (a site in which to collaborate) it is also a Content Management System (CMS) in which the Association executive and members can archive official documents as well as orchestrate a number of other private functions (for example, voting). Again, this is why a certain pages will only be accessible by qualified and authorized Association administrators. Hence, registered users may, on occasion, be refused access to certain pages or have limited privileges on others. Given that the IAACS site is a CMS it is preferable that you either create pages linked to your own pages OR you write a News item. The Community News allows for the free exchange of information between participants : anyone who has an account can publish news items or make announcements. Here, too, there are CONVENTIONS to RESPECT.
The site has been structured so that the those news items submitted in line with conventions will automatically be published on the News page. The most recent news items will appear first. There are four options : 1) the most recent news items (a maximum of three are displayed); 2) a monthly calender (described below); 3) - Older News items ( a maximum of three are displayed); and 4) a link to see All News]. That is, ALL the News items which have been published on the site.
How to manage the news
There are two tools to get used to: the Calender and the News Template.
The Calendar
The monthly calendar is a fantastic way to publish news.
How to READ a news item on the calendar
Calendar dates that have a red marking on them mean that here is at least one new item related to this particlaur date. One simply has to click on the red letter (the 22nd of May in the example) and one is sent to the first news item for that day. (Unfortunately, one cannot put more than one news item for a given day on the calendar. Hopefully this limitation will be fixed on the next version of MoinMoin). Of course the easiest way to have access to all the news is simply to click on the All News link.
How to PUBLISH a news item on the calendar
- Check that there no existing news items on the date of choice. (Please read the above paragraph if you do not understand this limitation.)
Click on the date you wish your news item to appear. A screen will appear proposing the creation of a page. (Note that the title of this page is a page associated with IaacsCommunityNews page. The wiki name - in this calendar context - is a date. In the example here it is : 2006-05-11.
- What if the date I want already has a news item published?
Click on the red letter on a given date. The page associated with this date will open. The CONVENTION is simple. You add -01, -02 or -03 in the navigation bar.
For example, in the case of a single news item published on 2006-05-22 one would do the following :
Then click on the Return key to go to the next screen:
The News Template
So that news items will be automatically displayed a particular news template MUST be used. From the list, please select : IaacsCommunityNewsTemplate.
Here is what you will see :
The first lines concerns the title. Change the Title of the news or announcements for the title you wish to appear. NOTE: It is IMPERATIVE to keep ONE space before and after the title so that the title markers ( == ) will work. To familiarise yourself with wiki formatting please consult thist page
The following line, which begins with the double #, indicates the authors name and publication date. Simply take out everything EXCEPT the expression beginning with @ followed by SIG which is followed by @ (No, there are NO spaces5,
One does NOT touch the sub-title Abstract
- Write your item where indicated. (This is the part of this page that will automatically appear on the News page).
Can several of us write on the same page at the same time?
Several writers on the SAME PAGE at the SAME TIME can pose problems (A wiki is not a chat). One persons work can be lost IF another person working on the same page decided to save their work at the same time. To avoid this the IAACS protocol is to privilege the first person editing a given page. The following message will appear for the first person editing a given page :
Other users will not be able to edit this page until 2006-05-15 17:12:19. Use the « Preview » button to prolong the period for which you wish the page to be locked.
Another message (on the last line of your navigator (at the very bottom, on your left) will indicate the length of time you have left and will begin to blink when the locking system has expired. This means that another user could, at that moment, edit the page and save it before you finish your changes. Yes, this means you could loose the changes made from your last “save”. Do not panic! Prolonging your time is easy, please see below.
What you need to know about pages that are temporarily locked:
- Such pages are locked for a duration of FIVE minutes.
- You can prolong your time (by five minute periods) by clicking on the « Preview » button. Know that even when the blinking message appears - saying that your time is up (over)- you can still simply click on « Preview » button to extend your time.
- If you choose to work on a page which is already being edited, a message will appear telling you who is working on the page and how much is left before the page becomes unlocked (that is, available for someone else to work on it).
- Five minutes is the default measure we have adopted for locking pages. We shall see over time whether this time line is suitable.
_________________________
If you have ideas as to how to make these instructions clearer please do not hesitate to write to ReneeFountain with your suggestions.
_________________________
Notes
If you are a participant and have logged in- this information will automatically be entered for you. (1)
Comments can be deleted in a MoinMoOin wiki which is an advantage compared to most CMS and most Wikis. Smetimes we make mistakes which we would like to correct. This is rarely permitted with respect to comments. On this site one can delete, then redo the comment. This can be done immediatly or later (provided you go back to the same machine and recall your password!) (2)
As you can see - and as was previously encouraged - it is MUCH easier -and wiser- to choose one's own password and signature. (3)
2f is the ascii hexadecimal code value / (4)
Sorry, but the perfect syntax cannot be done here without it enacting itself once this page is saved... (5)