ElectronicEdit

From PCTeXWiki

The information here describes adding material to the TPJ test site.  
If you want to help with this contact the with test site editor.

Check out the current issue from the TPJ subversion (svn) repository

  • Subversion (svn) is a version control system which allows multiple authors to add and change material in a central repository. All issues of The PracTeX Journal are currently organized into a single repository.
  • The details of TPJ's subversion system can be found at the TUG site. Here you will find instructions on how to install svn on your system, how to request a user account, and how to check out a copy of the repository.
  • It's usually best to check out only the current issue, as described at the page above.
  • The instructions below describe command line svn usage. There are also some excellent GUI svn clients. See the page above for some examples.

Post a paper on the tpj test site

  • make a directory for the author, e.g. "robertson". Do
$ cd site/2005-4        # use the current issue number
$ svn mkdir robertson
$ cd robertson
  • rename the main file with the same name as the directory, e.g. "mypaper.pdf" --> "robertson.pdf"
  • Make a png file of the author's email address. Use http://chxo.com/labelgen/ to generate the png file. Use the options
font name: Courier
font size: 12 pixels
background color: #ffffff
text color: #000000

Save the png as e.g. 'robertson.png".

  • add the files to the directory: robertson.pdf, example.tex, robertson.png ...
  • edit _abstract.html to make the intro page. Start with an _abstract.html from another author directory, add the new information, and then save it in the current author directory.
    • add the abstract
    • add the author bio and a link to the email png image
    • do not include a title -- that will be done automatically
  • add any links to be included in the html intro page in _links.txt. See a _links.txt in another directory for the format.
  • add the directory to the repository:
$ cd site/2005-4        # use the current issue number
$ svn add robertson/*
  • commit the changes
$ svn commit -m"added robertson paper"
  • when you have completed all this, let the issue editor know the directory and files are there; he/she will add appropriate entries to the issue driver file and recompile the web site including the new paper.
  • the paper will not appear on the staging site http://dw.tug.org/pracjourn/ until about an hour after Dave regenerates the web site. He typically does this every morning in the weeks leading up to a new issue.
  • if you have any questions on how to organize the directory, contact Dave Walden