WWP Book
Women Writers Project: blockimage Women Writers Online blockimage About blockimage Texts blockimage Encoding blockimage Site Index blockimage Contact

Creating and managing files at the WWP

Creating New Files in the WWP Office

  • Unlock the screen saver if necessary; log in and launch emacs.
  • Open the starter file for the text you want to begin work on: ~/tb/under_construction/[filename.xml]. WWP filenames have the format lastname.titleword.xml, so for Jane Smith's Poems Easily Forgot, the filename would be something like smith.poems.xml. You can find the filename listed in the Transcription database.
  • Check the new file out of version control: C-x C-q
  • Fill in the information that is missing from the TEI header (marked with $$$ signs) and start encoding.

Opening and Closing Files in the WWP Office

  • Launch X11 (by clicking on the icon in the dock).
  • Log into the unix server and launch emacs: edev [your username] (note that tab completion will work for your username)
  • Open your file:
    C-x C-f
    ~/tb/under_construction/filename
    If the shortcut above fails, the full filepath is /opt/local/projects/wwp/tb/(etc...)
  • Check the file out, if it's checked in:
    C-x C-q
    If it says "File has unlocked changes...", answer "no".
    When it asks "Revert to checked in version instead?" answer "yes".
  • Edit your file. Remember to save and validate often:
    C-x C-s to save the file
    C-c C-v to validate it with xmllint or other parsers.
  • When you're done with the file, make a change log entry:
    C-c L will create a new entry; fill in the necessary information
  • Save it and check the file back into the version control system
    C-x C-q (to check the file back in)
  • Enter a brief comment on what you did
  • Type C-c C-c to close the comment and finish checking in.
  • Kill the buffer: C-x k
  • When you are completely done for the day, log out of emacs:
    C-x C-c, then type "y" when it asks you if you REALLY want to...
  • Log out by typing "exit" at the prompt.
  • brownlogo