WEB GEOMETRY LABORATORY - Universidade de Coimbra
Contents
1. estimate that a normal bandwidth gt 20Mbps will be enough 5 2 WGL Open Project The Web Geometry Laboratory is an open source project The server must be hosted by an Web server the e g Apache server clients may use any Web browser available The database to keep constructions users information constructions permissions etc the DGS JavaScript applet the synchronous and asynchronous interaction are all implemented using free cross platform software namely GeoGebra PHP JavaScript AJAX JSON JQuery MySQL and Web standards like HTML5 CSS style sheets and XML WGL is an internationalised system with the English language as the default language and already localised to the Portuguese and Serbian languages lInternational Portugal http hilbert mat uc pt WebGeometryLab Serbia http jason matf bg ac rs wgl http webgeometrylab sourceforge net Chapter 6 Global Structure 30 CHAPTER 6 GLOBAL STRUCTURE Chapter 7 Collaborative Module 32 CHAPTER 7 COLLABORATIVE MODULE Chapter 8 Adaptive Module 34 CHAPTER 8 ADAPTIVE MODULE Chapter 9 DGS Integration 36 CHAPTER 9 DGS INTEGRATION Chapter 10 GATP Interation 38 CHAPTER 10 GATP INTERATION Chapter 11 Permission System 39 40 CHAPTER 11 PERMISSION SYSTEM Chapter 12 Database 7 codeTmpld INT 11 code TEXT userid INT 11 drawerld INT 11 n2. a classroom in synchronous interactions mediated by a teacher but also in synchronous and asynchronous remote access The main features of the Web Geometry Laboratory v1 4 are e n integrated DGS e A user s management module for administrator s teachers and students allowing the definition of classes and groups e A repository of geometric problems each user has his her own list of constructions e permissions system allowing the sharing or not of each construction between users and groups e A collaborative module where a given geometric task can be worked collaboratively by a group of users http hilbert mat uc pt GeoThms nttps moodle org 11 12 CHAPTER 1 INTRODUCTION e adaptive module allowing the capture of all the information regarding the students interactions with the system This information can them be viewed and analysed by teachers e chat to allow the exchange of short textual messages between users engaged in a collaborative session e forum to allow the exchange of messages between users about different subjects regarding the WGL In the next chapters we will describe all these features in detail 1 1 Base System A classroom session using WGL is understood as a Web laboratory where all the students eventually in small groups and the teacher will have a computer running Web browsers with the WGL site opened WGL is a client server application The W
3. pot index pot 3 Copy the template file POT to a translation file PO cp index pot index po 13 2 2 Translate 1 Use Emacs or Kbabel or another specialised program to make the translations 2 Transform the PO file in a 0 MO is binary version of the PO file to be use on run time msgfmt index po o index mo 13 2 3 Install the Translations 1 Copy the files 0 to the directory LOCALEDIR For example if you have in the PHP programa bindtextdomain index Locale Then you must do the following a If you have not done it yet create the Locale directory mkdir Locale b For every new language create the directory corresponding to that language Locale language code LC lt gt For example for the Portuguese Language mkdir pt PT LC MESSAGES c Copy all the MO file to that last directory 2 In order that all these settings became functional the package php gettext must be installed You can check that using then function phpinfo and then look for GetText Support enabled 13 3 TRANSLATIONS 2015 06 18 v97 45 13 3 Translations Language Translation Team Contact Status Vanda Santos Pedro Quaresma Serbian Milena Mari milena maric f gmail com good Portuguese vsantos gmail com good Table 13 1 Translations 46 CHAPTER 13 INTERNATIONALISATION LOCALISATION Bibliography Quaresma P Janici P 2007 GeoThms a Web System for euc
4. 12 1 Entity Relationship Diagram MySQL Workbench 41 LIST OF FIGURES List of Tables 4 1 4 2 4 3 13 1 Access to the Database Information 22 WGL Local Information File fragment 22 Electronic Message sent to Administrator 24 Translationg s 2 28 Pg bh Bos 45 LIST OF TABLES Part I User s Manual Chapter 1 Introduction The WGL platform had its roots in GeoThms a Web based framework for exploring geometric knowledge that integrates a DGS Geometry Automatic Theorem Provers GATPs and a repository of geometric constructions figures and proofs Quaresma and Janici 2007 From this system some of the authors developed a first system GeoGCLC where a DGS and a repository of geometric constructions were integrated into a Web based framework for learning geometry The difficulties encountered in the integration of GeoGCLC in the learning management system Moodle as SCORM module Wisher 2009 lead to the conclusion that there is a need for a more flexible approach regarding the integration of DGS applets in a learning environment Santos and Quaresma 2008 This led to the development of the Web Geometry Laboratory WGL With the development of WGL our aim was to build a blended learning Web en vironment for geometry with collaborative adaptive and automatic reasoning features An environment to be used in
5. 9 19 19 21 21 21 22 23 23 24 25 27 27 28 29 4 CONTENTS 7 Collaborative Module 31 8 Adaptive Module 33 9 DGS Integration 35 10 Interation 87 11 Permission System 39 12 Database 41 13 Internationalisation Localisation 43 13 1 Internationalisation 118 43 13 1 1 Environment Variables a 43 1342 PARTS ut ey usi e RR eU th ed Bag 43 13 2 Translation On ii h aset ae le de Ang ced t did 44 13 2 1 Prepare the Translation Files 44 131212 Translate 5 20 dti 44 13 2 3 Install the Translations 44 13 3 Translations z Lp Re ume sme 45 List of Figures 2 1 sCreating as Classic E ae ES 15 2 2 Groups to Students 15 2 3 Preparing a Task Angle Bisector 16 2 4 Collaborative Work Sessions to Groups Relationship 16 2 5 Collaborative Work Sessions Changing the Status 17 2 6 Collaborative Work Sessions Teachers Perspective 17 2 7 Playing Students Workbench 18 3 1 Collaborative Work Sessions Students Prespective 19 3 2 Collaborative Work Sessions Students Prespective Lock Released 19 4 1 New Teacher Registration Form 23 A2 Teachers LISTE bere Be mcg RE E 24
6. GL server is the place where all the information is kept the log in information the groups definitions the geometric constructions of each user the users activity logs etc The clients will access the server through a Web browser loading an instance of the DGS applet each and using the server to all the needed information exchange For a remote access to the WGL servers we estimate that a normal bandwidth gt 20Mbps will be enough There are four distinct types of users administrators teachers students and anony mous visitors The administrator s main role is the administration of teachers They have also access to the log in information off all users information that can be used to streamline the server Teachers are privileged users in the sense that they are capable of defining other users their students At the beginning of each school year the teachers should define all their classes the students in each class and if needed the aggregation of the students into groups The students each linked to a given teacher are able to work on the platform performing tasks created by their teachers and or pursuing their own work Students are unable to create other users Finally the anonymous visitor is a student type user not linked to any teacher and because of that unable to participate in collaborative sessions The purpose of this type of user is solely to allow unregistered users to test the WGL platform Each user teachers
7. User s amp DEVELOPER S MANUAL DRAFT VERSION WEB GEOMETRY LABORATORY URL http hilbert mat uc pt WebGeometryLab index php Pedro Quaresma amp Vanda Santos 2015 06 18 v98 Contents I User s Manual 1 Introduction 1 1 Base System 55 Dani 1 22 WGL Open Project searen Be ar BOXE 2 Teachers 21 Setting a Class i a kk Ro e WIRE gs RUBORE Sg 5 2 2 Preparing a Work session cop p aago nane a e a o ei 2 2 1 Teacher s Stand alone Work session 2 2 2 Teacher s Collaborative Work session 2 22 2 3 Adaptative 2 3 1 Capturing the Information 2 3 2 Visualising the Information 3 Students 3 0 8 Student s Stand alone Worksession 3 0 4 Student s Collaborative Worksession 4 Administrators 4 1 Setting a New ALT 5 55 vr ann a teer ate ie 412 WGIL Database eto ede eee mone a EE 42 Ndminstrating Users i um canoe X dn een ist hue Dr al Wo 4 2 1 Create new users 4 3 Adminstrating the Server II Developer s Manual 5 Introduction 5 l Base System d dk a eh Ge hae hae De ee 5 2 WGL Open Project sv Roo RR 4 245 Rs 6 Global Structure 11 12 13 15 15 15 16 16 16 16 16 1
8. XT Figure 12 1 Entity Relationship Diagram MySQL Workbench 41 42 CHAPTER 12 DATABASE Chapter 13 Internationalisation Localisation The system use the library gettext in order to allow the translation of all the output messages In the following the steps needed to adapt the PHP files to became tionalised and the translation procedure are described 13 1 Internationalisation i18n 13 1 1 Environment Variables LANG pt PT UTF 8 export LANG LANG pt_PT UTF 8 13 1 2 PHP i18n transform a non il8n PHP program into a il8n PHP program we have to set some global parameters and to transform all outputs 1 Global Parameters index php Specify the translation file directory and encoding bindtextdomain index Locale bind textdomain codeset index UTF 8 translation domain textdomain index 2 Transformation of all outpur instructions including a call to the gettext library echo lt center gt lt h2 class maketitle gt gettext Web Geometry Laboratory lt h2 gt lt center gt 43 44 CHAPTER 13 INTERNATIONALISATION LOCALISATION 13 2 Translation 110n 13 2 1 Prepare the Translation Files 1 Use the xgettex program to create a new translation template file POT xgettext from code utf 8 o index pot k_ kN_ index php 2 Use the msgmerge program to update a POT file msgmerge index po index pot gt novo_index pot cp novo index
9. ame VARCHAR 100 7 logsld INT 11 O figure BLOB L affiliation TEXT userid INT 11 usemame VARCHAR 16 url VARCHAR 100 timeLogin INT 11 userid INT 11 PI email VARCHAR 50 m timeLogout INT 11 name VARCHAR 20 dateSubmission DATE loginLogout INT 11 proverld INT 11 H usemame VARCHAR 16 websystem VARCHAR 15 proof MEDIUMBLOB passwd CHAR 40 proofResults TEXT type VARCHAR 20 1 cma 2 fgureld INT 11 7 webgeolabld INT 11 7 drawerld INT 11 code MEDIUMTEXT 2 majorVersion INT 11 7 name VARCHAR 50 codeXML MEDIUMTEXT 9 minorVersion INT 11 P 7 version VARCHAR 25 9 drawerld INT 11 buildVersion INT 11 AM url VARCHAR 50 dateSubmission DATE figureid INT 11 Indexes email VARCHAR 50 teold INT 11 dateSubmission DATE figure BLOB figure SVG MEDIUMTEXT m MEN T bibrefld VARCHAR 30 cription VARCHAR 30 SR 1 bibtexEntry TEXT idem authorid INT 11 drawerld INT 11 teold INT 11 teoName VARCHAR 80 2 description MEDIUMTEXT category VARCHAR 25 m 7 authorld INT 11 2 dateSubmission DATE Y bibrefld VARCHAR 30 name VARCHAR 100 userid INT 11 affiliation TEXT descriptionXML LONGTEXT Indexes url VARCHAR 100 shortDescription MEDIUMTEXT email VARCHAR 50 level INT 11 dateSubmission DATE codeXML MEDIUMTE
10. his can be changed during the installation Note that this must be the name that was specified above see Table 4 2 You should also create three new database users with access to that database again the usernames and passwords should be the same as in the file gttu php The three new users should have the following privileges User dbregular select insert update and delete User dbcontrib adds to that the lock tables privilege user dbadminpass is the administrator user so adding to those of the dbcontrib he has the show view create alter references index create view drop and create temporary tables privileges 4 2 Adminstrating Users The administrator s main role is the administration of teachers They have also access to the log in information off all users information that can be used to streamline the server 4 2 1 Create new users Confirm the registration of new users using the form New Teacher registration see Figure 4 1 any user can ask to be confirmed as user of the WGL In red all the mandatory fields in black the optional fields The designated administrator receive a electronic mail mensage whenever see Ta ble 4 3 someone tries to register in the system r New Teacher registration XA O A RR mw em E CA Figure 4 1 New Teacher Registration Form The confirmation or not is done accessing the Teachers Lis
11. laborative aspects of the WGL project Electronic Journal of Mathematics amp Technology 7 6 mathematics and Technology LLC Santos V Quaresma P 2013b Collaborative environment for geometry In Exper iment International Conference exp at 13 2013 2nd IEEEXplore pp 42 46 DOT 10 1109 ExpAt 2013 6703027 INSPEC Accession Number 14027552 Santos V Quaresma P 2013c Plataforma colaborativa para a geometria Indagatio Didactica 5 1 universidade de Aveiro Portugal 47 48 BIBLIOGRAPHY Wisher R 2009 SCORM 2004 Advanced Distributed Learning 4th
12. lidean constructive geometry Electronic Notes in Theoretical Computer Science 174 2 35 48 DOI 10 1016 j entcs 2006 09 020 Quaresma P Santos V Bouallegue 5 2013 The Web Geometry Laboratory project In 2013 Springer LNAI vol 7961 pp 364 368 DOI 10 1007 978 3 642 39320 4 30 Quaresma P Santos V Moral J 2014 Reproducing a geometric working session In England M Davenport J Kohlhase A Kohlhase M Libbrecht P Neuper W Quaresma P Sexton A Sojka P Urban J Watt S eds Joint Proceedings of the MathUI Open Math and ThEdu Workshops and Work in Progress track at CICM Aachen no 1186 in CEUR Workshop Proceedings URL http ceur ws org Vol 1186 paper 24 Santos V Quaresma P 2008 eLearning course for Euclidean Geometry In Proceedings of the 8th IEEE International Conference on Advanced Learning Technologies July lst July 5th 2008 Santander Cantabria Spain pp 387 388 DOI 10 1109 ICALT 2008 156 Santos V Quaresma P 2010 Adaptative Learning Environment for Geometry vol Ad vances in Learning Processes I Tech Education and Publishing KG Vienna Austria chap 5 pp 71 92 Santos V Quaresma P 2012 Integrating DGSs and GATPs in an adaptative and collab orative blended learning Web environment In First Workshop on CTP Components for Educational Software THedu 11 Electronic Proceedings in Theoretical Computer Science vol 79 p 111123 10 4204 EPTCS 79 7 Santos V Quaresma P 2013a Col
13. module for administrator s teachers and students allowing the definition of classes and groups repository of geometric problems each user has his her own list of constructions permissions system allowing the sharing or not of each construction between users and groups collaborative module where a given geometric task can be worked collaboratively by a group of users An adaptive module allowing the capture of all the information regarding the students interactions with the system This information can them be viewed and analysed by teachers A chat to allow the exchange of short textual messages between users engaged in a collaborative session forum to allow the exchange of messages between users about different subjects regarding the WGL Base System A classroom session using WGL is understood as a Web laboratory where all the students eventually in small groups and the teacher will have a computer running Web browsers with the WGL site opened 27 28 CHAPTER 5 INTRODUCTION WGL is a client server application The WGL server is the place where all the information is kept the log in information the groups definitions the geometric constructions of each user the users activity logs etc The clients will access the server through a Web browser loading an instance of the DGS applet each and using the server to all the needed information exchange For a remote access to the WGL servers we
14. on 04 update de construction DGS JavaScript applet Figure 2 3 Preparing a Task Angle Bisector 2 2 1 Teacher s Stand alone Work session 2 2 2 Teacher s Collaborative Work session Instructions Collaborative Work Sessions You must click on Update Sharing to save the changes Groups of students NG Haya mai To share a Collaborative Work Session with a group you select the Collaborative Work Session and then put a tick on the CWS to Groups groups name Relationship Ero s Classe A relates to 2 CWS NovaSess o Figure 2 4 Collaborative Work Sessions to Groups Relationship 2 3 Adaptative Module 2 3 1 Capturing the Information 2 3 2 Visualising the Information 2 8 ADAPTATIVE MODULE 2015 06 16 v90 17 Session Management Groups Management Construction Management See Students Work Create Collaborative Work Session 1110 n Status Details Edit Change Status 182 MeveSesso 20140220192708 pn m 1 160 Bisectrix construction 2014 03 19 17 46 34 open B m Change CWS Status buttons Change Collaborative Work Session Status Close A 4 4 Open Close Teachers only Start in Teachers only Teachers and Students students sessions lt map ap Figure 2 5 Collaborati
15. ross platform software namely GeoGebra PHP JavaScript AJAX JSON JQuery MySQL and Web standards like H TML5 CSS style sheets and XML The WGL is an internationalised system with the English language as the default language and already localised to the Portuguese and Serbian languages http webgeometrylab sourceforge net 14 CHAPTER 1 INTRODUCTION Chapter 2 Teachers 2 1 Setting a Class o Wie Geometry Labarakary aasa Iceweasel Web Geometry Laboratory Class Management Students Management Groups Management Userto Groups Management Students Navgeton Personal Information GeoConstruction to Groups Management GesConstructon Permissions Management Class Name Number of Students Figure 2 1 Creating a Class 2 2 Preparing a Work session Groups Management Usarto Groups Management Students Navigation GeoCansi jeoCansttuctian Permissions Management Groups Users students Groups to Students Relationship Student3 belongs to Group3 Instruetions You must click on Update Mer the char Toa puta tick on his name group are in blod italic Figure 2 2 Groups to Students Relationships 15 16 CHAPTER 2 TEACHERS sectrix of the internal angle of the two lines Description o Construction s description User s Name Date of Submissi
16. ss lt passwd_admin gt gt Table 4 1 Access to the Database Information File Web server user e g www data on a Debian Linux Apache server and that the file privileges should be rw r Le only the user and the group has read privileges The file server php contains all the local information regarding the directories lt php servers servidorHTML lt URL_local_host gt servidorMySQL lt MySQL_server gt entry points entradaURL lt entry_URL gt entradaFILE lt entry_Linux_Directory gt Server adminstrator email eAddressAdmin lt email_adminstrator gt Data base name databaseName lt database_name gt Sets de timezone correct date_default_timezone_set lt time_zone gt gt Table 4 2 WGL Local Information File fragment Again you need to fill in all the lt gt fields A last optional customisation regards the style files contained in the StyleSheets directory The main style file webgeometrylab css should be edited if for example you want to change the background colour 4 1 2 WGL Database Contained in the distribution is a file DB_SecurityCopies db_structureOnly sql This file has all the structure of the WGL database and after setting the database users is the file needed to re create the database 4 2 ADMINSTRATING USERS 2015 06 18 v91 23 The default name of the database is WebGeometryLab but t
17. students has access to a scrapbook in the server where she he can keep all the geometric construction produced using the DGS integrated in the WGL platform Each user will have full control over this personal scrapbook having the possibility of saving modifying and deleting each construction produced Each user has also access to the list of constructions made available by the other users 3International Portugal http hilbert mat uc pt WebGeometryLab Serbia http jason matf bg ac rs wgl 12 WGL OPEN PROJECT 2015 06 16 v90 13 To allow sharing geometric constructions among users a permissions system was implemented This permissions system is similar to the usual file permissions system but more flexible so far the users groups relationship is concerned allowing to specify reading writing and visibility permissions per geometric construction user and group By default the teachers will belong to all the groups they had created giving them the group access privilege to their students constructions Santos and Quaresma 2012 2013a 1 2 WGL Open Project The Web Geometry Laboratory is an open source project The server must be hosted by an Web server the e g Apache server clients may use any Web browser available The database to keep constructions users information constructions permissions etc the DGS JavaScript applet the synchronous and asynchronous interaction are all implemented using free c
18. ting page For example in figure 4 2 it can be seen that for user 824 the administrator can Confirm Registry or in a opposite decision to Remove User 24 CHAPTER 4 ADMINISTRATORS newTeacher register him herself at WebGeometryLab Name newTeacher Affiliation URL Electronic mail newTeacher email email Date of Submission 2015 06 03 Username newteacher Type ToBeConfirmed Table 4 3 Electronic Message sent to Administrator Teachers Listing 54 Users Add a new Teacher User Id Name username Figure 4 2 Teachers Listing 4 5 Adminstrating the Server The administrator can view the logs i e the user s access to the WGLserver All the accesses have a time stamp associated so this log information can be used to clean up the server removing users no longer using the system For the moment apart from confirming and removing users there are no adminis trative tasks to be preformed by the administrator Part II Developer s Manual 25 Chapter 5 Introduction With the development of WGL our aim was to build a blended learning Web environment for geometry with collaborative adaptive and automatic reasoning features An envi ronment to be used in a classroom in synchronous interactions mediated by a teacher but also in synchronous and asynchronous remote access The main features of the Web Geometry Laboratory v1 4 are 5 1 An integrated DGS A user s management
19. ve Work Sessions Changing the Status Student in a Group selection Session Management Groups Management Construction Management See Students Work Lock Owner Information Group selection 5114 15 92 send lt Teacher s Chat Window 4 GeoGebra s applet Figure 2 6 Collaborative Work Sessions Teachers Perspective 18 CHAPTER 2 TEACHERS e LP OO 4X mes e o 3 Figure 2 7 Playing Students Workbench Work Chapter 3 Students 3 0 3 Student s Stand alone Worksession 3 0 4 Student s Collaborative Worksession A Transfer bu A From Student to From Group to Stud V 2 2 Figure 3 2 Collaborative Work Sessions Students Prespective Lock Released 19 20 CHAPTER 3 STUDENTS Chapter 4 Administrators 4 1 Setting a New Server Setting a new server is possible given the fact that the WGL is a open source project To install a new WGL server you need to have a PHP compliant Web server e g Apache a MySQL server As a future development we will have a Debian Linux installation package and maybe other types but for the moment the installation of a WGL server is a non automatic procedure 4 1 1 WGL files As a first step you should access the SourceForge project at http webgeometrylab sourceforge net and do
20. wnload all the files to a directory of your chosen After downloading all file you have to create the files gttu php and server php The first one contains the information allowing to connect to the database the second some settings that allow the installation of the new server in any directory The file gttu php contains the usernames and passwords of three database users that must be created see Section 4 1 2 corresponding to three different access profiles see Table 4 1 You must fill the lt gt fields accordingly to the values you fixed when installing the database This file contains vital information and should be protected accordingly We suggest that this file be placed in a directory outside the WGL directory and without access by the Web server We also suggest that the owner and the group of this file should be the Inttp php net http www apache org 3https www mysql com SourceForge is a Web based service that offers a source code repository downloads mirrors bug tracking and other features It acts as a central location that software developers can use to control and manage free and open source software development 21 22 CHAPTER 4 ADMINISTRATORS lt php dbregular lt username_low_previlege gt dbregpass lt passwd_reg gt dbcontrib lt username_medium_previlege gt dbctrbpass lt passwd_contrib gt dbadmin lt username_high_privilege gt dbadminpa
Download Pdf Manuals
Related Search