80 likes | 176 Views
Repository/Site Upload Instructions. By Elizabeth Liang ewl6@duke.edu Duke University, May 2009 Alice Project under Prof. Susan Rodger.
E N D
Repository/Site Upload Instructions By Elizabeth Liang ewl6@duke.edu Duke University, May 2009 Alice Project under Prof. Susan Rodger
Follow these steps to upload a finished tutorial onto the alice09 repository webpage (http://www.cs.duke.edu/csed/alice09/). To transfer from the alice09 repository to the teacher website (http://www.cs.duke.edu/csed/alice/aliceInSchools/workshop09/tutorials.php) skip directly to step 7 Step 1: Create a Folder • Create a folder: Name it “nameOfTutorial” (shorten the name as needed, try to keep “tutorial” at the end though) • Create Documents: Each tutorial folder (* if applicable) should have • nameOfTutorial.ppt (powerpoint document) • nameOfTutorial.pdf (one slide per page) • nameOfTutorialHandout.pdf (handout, 4 slides to a page) • *nameOfTutorialStart.a2w (starting alice world) • *nameOfTutorialFinished.a2w (finished alice world) • *exercises.html (webpage to put exercises) • nameOfTutorialScreen.jpg (screenshot associated with tutorial) • tutorial.php (code for the repository) • publicTutorial.php (code for the teacher website)
Step 2: Tutorial PHP Code • For tutorial.php create a new document in a html/text editor • Insert the following code, replacing/deleting information as needed: (parent folder means either gettingStartedTutorials or advancedTutorials depending on the tutorial) <p class="tutorial"> <img src="tutorials/parentFolder/nameOfTutorial/nameOfTutorialScreen.jpg" alt=""> <b>Name:</b> NameOfTutorial<br> <b>Level:</b> Beginner/Intermediate/Expert<br> <b>Time:</b> Approx. time it takes to do the tutorial<br><br> <b>Description:</b> Description of tutorial and the concepts it covers (2-3 sentences).<br><br> <b>Worlds:</b> <a href=“tutorials/parentFolder/nameOfTutorial/nameOfTutorialStart.a2w”>Start</a>, <a href=“tutorials/parentFolder/nameOfTutorial/nameOfTutorialFinished.a2w”>Finished</a><br> <b>Links:</b> <a href="tutorials/parentFolder/nameOfTutorial/nameOfTutorial.ppt">Powerpoint</a>, <a href="tutorials/parentFolder/nameOfTutorial/nameOfTutorial.pdf">Slides (.pdf)</a>, <a href="tutorials/parentFolder/nameOfTutorial/nameOfTutorialHandout.pdf">Handout</a>, <a href="tutorials/parentFolder/nameOfTutorial/exercises.html" target="_blank">Exercises</a> </p>
Step 3: Public PHP Code • For publicTutorial.php create a new document in a html/text editor • Insert the following code, replacing/deleting information as needed: (parent folder means either gettingStartedTutorials or advancedTutorials depending on the tutorial) <p class="tutorial"> <img src=”workshop09/tutorials/parentFolder/nameOfTutorial/nameOfTutorialScreen.jpg" alt=""> <b>Name:</b> NameOfTutorial<br> <b>Level:</b> Beginner/Intermediate/Expert<br> <b>Time:</b> Approx. time it takes to do the tutorial<br><br> <b>Description:</b> Description of tutorial and the concepts it covers (2-3 sentences).<br><br> <b>Worlds:</b> <a href=“workshop09/tutorials/parentFolder/nameOfTutorial/nameOfTutorialStart.a2w”>Start</a>, <a href=“workshop09/tutorials/parentFolder/nameOfTutorial/nameOfTutorialFinished.a2w”>Finished</a><br> <b>Links:</b> <a href=”workshop09/tutorials/parentFolder/nameOfTutorial/nameOfTutorial.ppt">Powerpoint</a>, <a href=”workshop09/tutorials/parentFolder/nameOfTutorial/nameOfTutorial.pdf">Slides (.pdf)</a>, <a href=”workshop09/tutorials/parentFolder/nameOfTutorial/nameOfTutorialHandout.pdf">Handout</a>, <a href=”workshop09/tutorials/parentFolder/nameOfTutorial/exercises.html" target="_blank">Exercises</a> </p>
Step 4: Exercises Code • For exercises.html create a new document in a html/text editor • Insert the following code, replacing information as needed: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="Content-type" content="text/html;charset=UTF-8”> <title>NameOfTutorial Exercises</title> </head> <body> <h2>NameOfTutorial Exercises</h2> <p> Text for the exercises go here, just a few suggestions that can be used as follow up/homework. </p> <p> <a href="http://cs.duke.edu/~rodger">Susan Rodger</a> // Duke University Department of Computer Science // Summer 2009 </p> </body> </html>
Step 5: Uploading • Connect to the CS server. (If you do not have a FTP/SSH program download one from http://www.oit.duke.edu/comp-print/software/list.html, go down to “Security, SSH/SFTP and firewalls.” I use fileZilla but any of those should work.) The server name is login.cs.duke.edu, use your cs username and password, the port is 22. • Once you have successfully connected it will automatically go to your cs space. Go to the root folder by clicking the folder with just a “/” after it. • Enter in the address “/usr/project/csed/web/alice09/tutorials/parentFolder” • Drag the nameOfTutorial folder from your computer into that space. • Open the tutorial.php document in the parentFolder and download it onto your computer (drag it somewhere where you can find it). • Open it in a html/text editor and where you want to add the tutorial (for example at the end or after a certain tutorial that is already there) on the page insert the following code, replacing information as needed. Reupload when done. <?php include (”nameOfTutorial/tutorial.php"); ?>
Step 6: Testing and Troubleshooting • Open a web browser and go to the repository page (http://www.cs.duke.edu/csed/alice09/). Your tutorial should now be on the page, if a warning shows go back and double check your php code, making sure the syntax and spelling is correct. • If the picture and text do not line up correctly (the picture after it seems indented into the page) go back to the php code and add <br><br> tags right before the </p> tag. You will need to change both tutorial.php and publicTutorial.php. Upload the modified documents into the appropriate folder. You do not need to modify tutorial.php in the parent folder again. • If something still doesn’t work, let Liz know and we’ll try to figure it out. • If everything looks ok, then congratulations you’re done with another tutorial! Cross it off the whiteboard and update your blog. • If you also need to upload it onto the teacher website (check with Professor Rodger first) then continue onto step 7.
Step 7: Directory Transfer • Transfer the nameOfTutorial folder from “/usr/project/csed/web/alice09/tutorials/parentFolder” into “/usr/project/csed/web/alice/aliceInSchools/workshop09/tutorials/parentFolder” • Update (download, change, reupload) parentFolder’s publicTutorial.php with the following code placed where you want the tutorial to display (for example at the end or after a certain tutorial), replacing information as necessary: • Open a web browser and go to http://www.cs.duke.edu/csed/alice/aliceInSchools/workshop09/tutorials.php to check that the tutorial displays properly, if it doesn’t check the spelling and syntax in the php code that you inserted earlier. <?php include (”nameOfTutorial/publicTutorial.php"); ?>