Everything you always wanted to know about reading lists... ============================================================ This is kind of long because is detailed. Attend the next class (9/25) from the beginning (be on time!) and this will be a breeze. First, go to http://vis.cs.brown.edu/resources/lists.html There's a list of reading lists (...) that various people in the group have created. They are basically collections of documents that relate to a subject. The subject could be a project (although that belongs in the project's webpage also in visweb), a small sub-project someone is working on, a personal bibliography of interesting things, etc. It could be anything you want, really. The cool thing about this is that other people can access those lists and you can share information easily with people this way. For the class ============= You need to make one reading list about your project proposal. I created one list per person already, now you'll need to fill them out. Since you are not group 'graphics' I needed to do that for you. The lists are empty now and have your name in the title. To get started... ================= Read /pro/web/web/courses/cs237/txt/get-started.txt The importat bit is in section II, but you should read the whole thing to understand a little bit what you are doing. You'll need this to make your reading list show up on the web. Once you get your shell to recognize $G (you should be able to 'cd $G'), you may continue with this tutorial. If you cannot get it to work email me (daf@cs) and I'll help you. To add a document ================= You need to be on a linux box in CS. Physically! No remote login. Here are the steps: 1.- Check that the document in question is not already in visweb Go to http://vis.cs.brown.edu/search and look for title, author's last name, venue/journal, etc. a) If you find it: Write down the entry key. Something that looks like Acevedo-2002-ACR (that's lastname-year-acronym). That's the key that identifies an entry in visweb. IT IS CASE SENSITIVE!! Now you need to figure out whether this paper is considered bibliography (external publication, i.e., non-Brown-CS-Graphics) or publication (Brown CS Graphics publication). Click on the 'Update' link at the top right of any visweb page. Type the entry key you wrote down in the space provided. Don't worry about the document type pull down. Click 'Continue' The next web should tell you whether it is a 'bib' or a 'pubs' type of document. Write it down. Go to step 3! b) If you DON'T find it: Create the entry key your document will have in visweb. That's the key that identifies an entry in visweb. IT IS CASE SENSITIVE!! It has three parts: lastname-year-acronym + The 'lastname' is the first author's lastname, first letter capitalized. + The 'year' is the year of publication. + The 'acronym' is formed by the first letters of the first three words you capitalize in the title of the document. ALL CAPITALS! Example: "The Role of Visual Perception in Data Visualization" by Mehdi Dastani Published in Journal of Visual Languages and Computing in December 2002 The key would be: Dastani-2002-RVP You are ready to create the document in visweb. Go to step 2. 2.- Adding a new document to visweb + Click on the 'Update' link at the top right corner of any visweb page. + Click on the 'Document' link + Select 'Bibliography' from the pull down menu. Your document is type 'bib'! REMEMBER THIS! + Write your document's entry key + Click Continue A page beginning with 'Creating a new entry..." should show up. + Skip to the bottom of the page where 3 pull down menus are. + Select the type of document your entry is + Select the status + Leave the last menu in 'VRL internal access'. This will make your document's pdf only accesible by password (copyright issues...) + Click 'Continue' A page to add information about the document should show up. Fill out AT LEAST the fields with a '*' by them. + Type the authors separated by 'and' with no commas anywhere. For example, if the paper lists: Acevedo, D., Vote, E. and Laidlaw, D. First of all that's a mess, but in any case, you should enter that list as: D. Acevedo and E. Vote and D. Laidlaw + Skip the 'Location...' fields. We'll add the document itself from a shell. + Click 'Continue' You are almost done. Following the instructions on the page that shows up: + Go to a shell and type 'viswebupdate' (you should have this command already because you set up the $G variable before) 3.- Adding the document to your list a) If your document is of type 'bib' + On a shell type 'addviswebbib entrykey listname.txt' 'entrykey' is the key you created or found out in step 2. 'listname' is the name of the file that contains your list: - Go to http://vis.cs.brown.edu/resources/lists.html and click on the link to your list. - Look at the last part of the address. For example: Daniel Keefe's Bibliography list has 'dfk.html' at the end of its address. In this case 'dfk' is the 'listname' you would use. + IMPORTANT!! Reply 'n' to overwritting the file mentioned. b) If your document is of type 'pubs' + On a shell type 'addviswebpub entrykey listname.txt' 'entrykey' is the key you created or found out in step 2. 'listname' is the name of the file that contains your list: - Go to http://vis.cs.brown.edu/resources/lists.html and click on the link to your list. - Look at the last part of the address. For example: Daniel Keefe's Bibliography list has 'dfk.html' at the end of its address. In this case 'dfk' is the 'listname' you would use. + IMPORTANT!! Reply 'n' to overwritting the file mentioned. YOUR DOCUMENT HAS NOW BEEN ADDED TO YOUR LIST!! If you have a pdf,ps,doc,txt or ppt that you want to add also, go to step 4. Otherwise, type 'viswebupdate' and your document should show up on the web. 4.- Adding a pdf,ps,doc,txt or ppt file for your document IMPORTANT! If the document you want to add was ALREADY in visweb, go to your newly updated reading list and see if the it has a pdf, or ps, or any of those already. If it does, YOU ARE DONE!! + For pdf type: 'addviswebpdf full_path_to_file entrykey' + For ps type: 'addviswebps full_path_to_file entrykey' + For doc type: 'addviswebdoc full_path_to_file entrykey' + For txt type: 'addviswebtxt full_path_to_file entrykey' + For ppt type: 'addviswebppt full_path_to_file entrykey' + Type 'viswebupdate' to update the webpage. 5.- YOU ARE DONE!!! Well, that was easy, ha?