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)