Pliant documentation forum

Pliant documentation forum

On Pliant's Home page

Message posted by marcus on 2004/01/04 16:25:08
Hi all.

Happy New Year.

I am currently finalizing the preparation of a course here at Ryerson in which I 
will use Pliant as the suggested programming language. 63 students are registered
in it.

To help them lern the language, I have set up my unofficial Pliant Home page. The
idea was to facilitate their access to documentation and installation.

In my view, the way the pliant.cx home page is set up is a bit misleading.

My unofficial Pliant home page is available at 

http://playground.scs.ryerson.ca:8080/newindex.html

I would suggest we adopt a similar design for pliant.cx's. Let me explain how 
it would work.

The left menu would consist of the following tentative links:

Home - points to a document under pliantdocs
News - points to a document under pliant.cx. Hubert would be the one updating it
Download - points to a document under pliantdocs
Documentation - points to a document under pliantdocs, obviously
Forums - points to a document under pliant.cx.
Applications suite - points to a document under pliantdocs
The Pliant team - points to a document under pliantdocs
Services - points to a document under pliant.cx. Its contents would be what we 
current have under the Section 'Some pliant services' in pliant.cx

As you may have noticed, in my unofficial pliant home page, the link 'services'
does not exist. I have a link to pliant.cx instead

Is this implementable for pliant.cx

Please send critics.
Message posted by hubert.tonneau on 2004/01/04 16:34:47
Your site seems more natural.

Also I have to plan to redesign Pliant site at the moment because the vector
drawing part of Pliant, including the Pliant browser and PDF filter is improving
rapidely, so what shall be done will be much clearer in a fiew monthes.

At some point, we might have Pliant web site accepting PDF files for the
documentation, and properly render these to a standard browser with no PDF
plugin (using server side rendering), and we might include PDF illustrations
in the middle of .page files (just as if they where .png), etc.

Also I fully understand that the current situation is a bit a nightmare for the
documentation team, so feel free to ask me to add some links to external sites.
Message posted by marcus on 2004/01/04 19:28:46
I deem the following changes should be implemented as soon as possible:

- replace index.page file in /pliant/pliant/ with the following index.html file:

<HTML>
   <HEAD>
      <TITLE>
         Pliant Web page
      </TITLE>
<script src="http://piant.cx/common/pliant.js" language="JavaScript" type="text/javascript"></script>
   </HEAD>
<FRAMESET frameborder="no" framespacing=0 COLS="*,80%">
        <FRAME NAME="MENU" SRC="menu.html">     
        <FRAME NAME="MAIN" SRC="main.html">
  </FRAMESET>
</HTML>

- add to /pliant/pliant/ the following menu.page file:

goto_url "http://pliant.cx/pliantdocs/babel/universal/menu.html"

- add to /pliant/pliant/ the following main.page file

module "/pliant/language/context.pli"

title "Pliant - release "+string:pliant_release_number "/pliant/welcome/image/pliant.png" "/pliant/welcome/philosophy.html#logo"

execute_dynamic_page "http://pliant.cx/pliantdocs/babel/universal/pliant/welcome/mywhatisit.html"

- add to /pliant/pliant/ the following news.page file

header "News about Pliant"  
   
para  
   [Release 88 is a back to stable release after the deap changes in the HTTP server part introduced in release 85.]  
para  
   [See ] ; link "changes log" "/pliant/welcome/changelog/" ; [ for extra details.]

- add to /pliant/pliant/ the following services.page file (copy-pasted from 
pliant.cx, the line numbers not removed)

module "/pliant/language/context.pli"  
module "/pliant/admin/file.pli"  
module "/pliant/fullpliant/user.pli"  
module "/pliant/fullpliant/this_computer.pli"  
module "/pliant/appli/mail/count.pli"

 
 72  header "Some Pliant services"  
 73   
 74    table columns 1 border 0  
 75      if user_name<>""  
 76        var Int count := 0  
 77        each b user:user_name:mailbox  
 78          count += 1  
 79        if count>0  
 80          cell  
 81            link "Mailbox"+(shunt count>1 "es" "") "/pliant/browse/mail/"  
 82            var Int count := mail_count  
 83            if count>0  
 84              fixed [  ] ; highlight "you have "+string:count+" mail"+(shunt count>1 "s" "")  
 85            eol  
 86            text "Will allow you to send mails, read your received mails, and search your mail archives."  
 87      if false # user_name<>""  
 88        cell  
 89          link "PIM" "/pliant/appli/pim/" ; highlight " new" ; eol  
 90          [Record and search in your personal informations database and agenda.]  
 91      if allowed:"administrator"  
 92        cell  
 93          link "The Pliant interpreter" "/pliant/appli/interpreter" ; eol  
 94          [Will allow you to write and test your first tiny Pliant programs using your web browser.]  
 95      if (allowed:"browse_path" or allowed:"browse_file" or allowed:"browse_data")  
 96        cell  
 97          [Browse Pliant ] ; link "files" "/pliant/browse/file/"  
 98          [ or ] ; link "datas" "/pliant/browse/data" no_extension  
 99          [ or ] ; link "types" "/pliant/browse/type/" no_extension  
 100          [ or even ] ; link "system files" "/pliant/browse/system_file/" no_extension ; eol  
 101          [This will allow you to travel through Pliant site files tree or database and view individual files or datas.]  
 102      if allowed:"browse_configuration"  
 103        cell  
 104          link "Configuring the server" "/pliant/fullpliant/configure" ; eol  
 105          [This will allow you to setup the Pliant HTTP, SMTP, ... servers, using a user friendly interface with inline documentation.]  
 106   
 107  para  
 108    execute_dynamic_page "pliant:/pliant/protocol/http/login.html"  
 109   
 110  para  
 111    small  
 112      [This website is powered by ]  
 113      if (constant this_computer:env:"pliant":"system":"distribution"="fullpliant")  
 114        [FullPliant operating system]  
 115      else  
 116        [Pliant HTTP server]  
 117      [ / View server ] ; link "status" "/pliant/fullpliant/status"  
 118      if allowed:"administrator"  
 119        [ or ] ; link "trace" "/pliant/protocol/http/trace"  
 
- and finally, upload to extra1.fullpliant.org the pliant.tgz tar ball with the
uptodate documentation I just sent to Hubert (by email)