Useful links and basic use of the Subversion System (svn)
A practical guide to Linux Commands, Editors, and Shell
Programming- by Mark G. Sobell, Second Edition
- You can follow the Unix Tutorial from Colorado College
- Command index for the Apple OS X command line
- You may ask me for a copy of the book: Mac OS X Tiger edition: The missing manual- by Chris Stone
Learning tcsh MAC OS X terminal (2001 notes) - by Chris Stone
(see also, why use a command line instead of Windows? and why Linux is Better? )
The Fink project
Emacs editor & Latex
Free basic tutorials on high-level programming
CSS Website creation and Apache Web Server
- CSS Tutorial - Starting with HTML and CSS
- How to create a website with CSS
- You can copy Andrew Kwok's website folder available here and use it to create your first website folder (please leave the copyright design note at the bottom of index.html to acknowledge Andrew's work; otherwise use your own css style file).
- jemdoc , free software to create websites.
- The Apache Web Server
Subversion control system
A book on Subversion can be found here. Follow these instructions to install Subversion and work with it in a Linux/Mac computer:
- Install a copy of svn on your personal computer (you do not need the server, only the client). Svn is supported by Windows, Macs and Linux. For Windows, TortoiseSVN or RapidSVN are two available options. These are two open source software tools and the instruction manuals can be found in those websites. For Macs, you can use the free svn client SvnX or install it through fink to use it through a terminal.
- Ask Sonia for a password.
- Check out the bib files (to be done only once). First, go to the
svn checkout http://fausto.dynamic.ucsd.edu/svn/repos/bib
At this time, the only bibtex file that is writable to you is SMD-add.bib (for changes to the other files, please send me email) But you can use the other bib files available there.
Check out the folder of the paper (to be done only once per new
paper). First go to your papers folder. Then type
svn checkout http://fausto.dynamic.ucsd.edu/svn/repos/papers/Name-of-folder
(Substitute Name-of-folder by the desired directory) To get slides you can type
svn checkout http://fausto.dynamic.ucsd.edu/svn/repos/slides/Name-of-folder
- Each time you start working on the file(s), you should get the
latest version by typing:
- To add a file to the database, type:
svn add filename
- To remove a file from the database, type:
svn delete filename
- Each time you finish working, you should first svn update and
then commit your changes back to the database by typing (do not be
afraid of losing your changes, svn takes care of that with conflict
resolution, see next):
svn commit -m "type a message here"
- Look at the output of the command, in particular look for
conflict warnings. If there is a conflict, then you must resolve it
before re-committing the changes. Several options may be given to you,
choose the "postpone" p option that does not ignore the conflict
(other options to ignore the conflict may make the changes made by the
other person disappear!)
- edit the file in question (say SMD-add.bib or main.tex) and look for
There will be two versions of the same paragraph. Choose the right one and delete the other.
- type: svn resolved main.tex
- type: svn commit -m "resolved conflict"
- edit the file in question (say SMD-add.bib or main.tex) and look for the
- If you want to create a new project, or folder with a new paper,
let me know, as I only have that permission. You can create subfolders
of existing folders. You can download the files with a web browser by
(Substitute Name-of-folder by the desired directory)
- If you would like to look the history of changes in the
paper/project, the different paper versions, who made the changes, and
what comments this person added on the new version, type inside the
- If you want to open a particular version of the paper/project, for
example version 976, then type:
svn update -r 976
The new updated file you will obtain will be version 976. Then you can move this file temporarily into main-temporary.tex, and svn-update again to obtain the current version. To find the version you would like, you can first look it up with svn log. If you would like to access the paper versions in a fast way, you can add a new file to the folder named 'paper-versions.txt' where you write down the number of the versions you would like to keep track of.