Welcome to Caltech Templates Contents: I. Adding content to your site on your local machine II. Transferring your edited files to the web server using SCP III. Instructions for unpacking your .zip file on the web server rather than on your local machine These instructions assume that you have downloaded your web template to your desktop as a .zip file, and that you have web space on the "ITS cluster" or another server that has server side includes (SSI) turned on. Note: the templates system requires SSI in order to function. Please do not proceed with your template if you are in doubt about this; you should contact your server administrator with questions. If you admin asks, these templates do NOT need SSI exec turned on, but they do assume that includes are being processed for files with the extension .html, not just for files with the extension .shtml I. Adding content to your site on your local machine If your downloaded file did not "unpack" itself automatically, double click on the .zip file to extract it. You should now have a folder on your desktop -- we'll call it "filePDQ" for reference purposes in these instructions -- with the same name as the .zip file (minus the .zip). When you look inside filePDQ, you should see the following files: index.html this is the homepage for your new site reference.html this is an html cheatsheet that lists common html tags you might like to use in making your site. include_dir this folder contains elements of your site that you do not need to touch multiple folders with names that reflect the navigation you specified for the site. Each folder has a file in it called 'index.html'. These files should stay inside their folders; they are the individual pages of your site. Putting Content on Your Site: You can edit your site files on your local machine, or on the server. (If you would rather edit on the server, see the instructions "editing on the server" below). We'll start by editing the index.html file directly inside filePDQ. This is the "homepage" of your site. Please open the file using web authoring software like Dreamweaver or FrontPage, or a simple text editor (like TextEdit, SimpleText or Notepad-- please do not use MS Word). Note: if you use Dreamweaver you will be able to use the "preview in browser" function to see your pages from your local machine as you work on them. The page content for index.html goes between the two "comment" tags, which look like this:

Home page content You will need to use some basic html tags to create paragraph breaks, boldface, hyperlinks, etc. These can be found in the file 'reference.html' in your web templates folder. Use your web browser to view this file to look up the tags you will need and to see how your style sheet will format different sections of your pages. After you've edited your homepage, you may now proceed to the other index.html files that reside in the various file folders. These are the subpages of your site, and they correspond with your navigation. Once you have content on all of your pages, you will want to put the files on the web server. II. Transferring your files to the web server using SCP Windows users, install WinSCP (http://winscp.net/eng/download.php) Mac users, install Fugu (http://rsug.itd.umich.edu/software/fugu/download.html). If you don't have administrative access to your computer, you will have to ask your system administrator to do this for you. These programs allow you to securely connect to the server and 'drag and drop' your files from your local machine to the server. You connect to the server by typing 'its.caltech.edu' into the host field and your account's username and password into their appropriate fields. Once the connection is made, you will be able to see both the server and your desktop in separate panes. You will want to navigate into the 'public_html' folder on the server, and into the web templates directory on your local machine. Everything inside the folder filePDQ (but not the folder itself) will go into the "public_html" folder on the server e. g.: /home/ yourusername/ public_html/ index.html reference.html include_dir [multiple folders] III. Instructions for unpacking your .zip file on the web server rather than on your local machine 1) Using pscp and putty (Windows) 1. Download pscp.exe and putty.exe to your desktop (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) 2. Open a the command prompt and 'cd' to your desktop (C:\Documents and Settings\SomeUser\Desktop) 3. Transfer the zip archive to ITS by typing 'pscp filePDQ.zip username@its.caltech.edu:~' (where 'filePDQ ' is the name of your downloaded web folder); type your password at prompt and watch the file transfer, then 'exit' 4. Double click on the putty.exe icon and use ssh to log into its.caltech.edu 2) Using the Mac OS Terminal App 1. Launch terminal app 2. Type 'cd Desktop' (assuming your files are on the desktop; if not, cd to their location) 3. Type 'scp filePDQ.zip yourname@its.caltech.edu:~' and your password, then watch the file transfer. 4. Type 'ssh yourname@its.caltech.edu' 1&2) Steps for both 5. Backup the current site by typing 'tar Ðcvf site-backup-2005-12-25.tar public_html' - substituting today's date in the file name. (This way, you can always go back to your current site by replacing the new site with the files from this backup.) 6. Now unpack the template archive by typing 'unzip filePDQ.zip'; this will create a folder called filePDQ.zip in your home directory (next to your public_html directory) 7. Edit the index.html files in each directory and sub-directory to add content to your site's pages. You can use any of the common Unix text editors (emacs, vi, pico). 8. When you are satisfied with your content, make the filePDQ directory into your public_html directory so it becomes your live web site: "mv filePDQ public_html" 9. Check new site. Use a browser to navigate to http://www.its.caltech.edu/~yourname (where 'yourname' is the name for your ITS account).