home *** CD-ROM | disk | FTP | other *** search
/ linuxmafia.com 2016 / linuxmafia.com.tar / linuxmafia.com / smaug / how-to-work-on-the-smaug-web-site < prev    next >
Text File  |  2012-03-17  |  3KB  |  61 lines
  1. http://web.archive.org/web/20030513233638/http://sourceforge.net/docman/display_doc.php?docid=9025&group_id=13487
  2. This page had:
  3.  
  4. Title: How to Work on the Smaug Web Site
  5. Description:  Description: Everything you need, to help maintain our site
  6.  
  7. Smaug Is Looking for a Few Good Webfolk
  8.  
  9. [This document needs some fixing, because David A. Gatwood designed into the site some templates that this doc doesn't yet cover, and because there are some matters of syntax requirements and site policy that aren't yet covered here, either. So far, those are explained only in David's mailing list posts.]
  10.  
  11. Smaug can always use people willing to help with the Web site. If you want to help, good! Thanks for offering.
  12.  
  13.  
  14.  
  15. Starting Out:
  16.  
  17. The easiest way is to grab a copy of the HTML, edit to suit, and then put 
  18. it up on a Web site and show the group what you've done. (Ask on the 
  19. mailing list [http://lists.svlug.org/lists/listinfo/smaug] if you need 
  20. Web space for this.)
  21.  
  22. Easiest way to do this from the Linux command line[1] is this:
  23.  
  24. cvs -d:pserver:anonymous@cvs.smaug-web.sourceforge.net:/cvsroot/smaug-web login
  25. cvs -z3 -d:pserver:anonymous@cvs.smaug-web.sourceforge.net:/cvsroot/smaug-web co htdocs
  26.  
  27. These two commands will give a local ("checked out") copy of the current 
  28. site HTML. Once you're done editing your local copy to implement your 
  29. fixes/ideas/general-sprucing-up, please post something about it to the 
  30. mailing list, so we can see what you've done.
  31.  
  32. (You can also just browse 
  33. [http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/smaug-web/htdocs/] 
  34. individual files in the CVS tree, if you wish.)
  35.  
  36. Anyhow, the site is in relatively simple HTML (v. 4.01 Transitional) with 
  37. a few tables. The right-side navigation buttons are JPEGs with white text 
  38. in the "Comic Sans" typeface (about 16 point or 12 pixels), sometimes 
  39. called "comic sans ms". You'll find that typeface furnished standard in 
  40. The GIMP, among other places. 
  41.  
  42. Developer Access:
  43.  
  44. Persistently helpful people will be added as "developers" to the SourceForge 
  45. Smaug-Web project [http://sourceforge.net/projects/smaug-web/]. You'll then 
  46. be able to check in changes to the Web site, without help. Do so like this:
  47.  
  48. export CVS_RSH=ssh
  49. cvs -z3 -d:ext:developername@cvs.smaug-web.sourceforge.net:/cvsroot/smaug-web ci htdocs
  50.  
  51. (Alternatively, scp your new files to your SourceForge home directory on shell.sourceforge.net, and then check them into CVS locally.)
  52.  
  53. (You must have software installed supporting the SSH v. 1.x AKA "ssh 1" protocols.) Your changes will be auto-applied to the live site within the hour. Don't worry to much about other developers objecting: If they (or you) object to your changes, CVS lets them be easily reverted to prior versions. That's part of why we use version control.
  54.  
  55. Do not attempt to edit the live site HTML directly: That just wastes your time. Why? Because developer dgatwood auto-runs a script called "web_update" at five minutes past each hour, overwriting the site HTML with a fresh checkout from CVS. web_update is in /groups/s/sm/smaug-web, and yes, you're welcome to run it manually after checking in changes, instead of waiting for dgatwood's cronjob. 
  56.  
  57. [1] If you're on MS-Windows, you will need one of the MS-Windows ports of the command-line cvs tool, or WinCVS. For some pointers, check for a document stored alongside this one in SourceForge's Document Manager called "How to run CVS with SSH under Windows 9x/NT/2000".
  58.  
  59.  
  60. -- Smaug Web staff
  61.