GitHub - allthingsgo/virgule: A private fork of raph-rainwater

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commits
COPYING		COPYING
ChangeLog		ChangeLog
INSTALL		INSTALL
Makefile		Makefile
README		README
acct_maint.c		acct_maint.c
acct_maint.h		acct_maint.h
aggregator.c		aggregator.c
aggregator.h		aggregator.h
apache_util.c		apache_util.c
apache_util.h		apache_util.h
article.c		article.c
article.h		article.h
auth.c		auth.c
auth.h		auth.h
buffer.c		buffer.c
buffer.h		buffer.h
certs.c		certs.c
certs.h		certs.h
db.c		db.c
db.h		db.h
db_ops.c		db_ops.c
db_ops.h		db_ops.h
db_xml.c		db_xml.c
db_xml.h		db_xml.h
diary.c		diary.c
diary.h		diary.h
eigen.c		eigen.c
eigen.h		eigen.h
foaf.c		foaf.c
foaf.h		foaf.h
hashtable.c		hashtable.c
hashtable.h		hashtable.h
mod_virgule.c		mod_virgule.c
net_flow.c		net_flow.c
net_flow.h		net_flow.h
private.h		private.h
proj.c		proj.c
proj.h		proj.h
rating.c		rating.c
rating.h		rating.h
req.c		req.c
req.h		req.h
rss_export.c		rss_export.c
rss_export.h		rss_export.h
schema.c		schema.c
schema.h		schema.h
site.c		site.c
site.h		site.h
style.c		style.c
style.h		style.h
tmetric.c		tmetric.c
tmetric.h		tmetric.h
util.c		util.c
util.h		util.h
wiki.c		wiki.c
wiki.h		wiki.h
xml_util.c		xml_util.c
xml_util.h		xml_util.h
xmlrpc-methods.c		xmlrpc-methods.c
xmlrpc-methods.h		xmlrpc-methods.h
xmlrpc.c		xmlrpc.c
xmlrpc.h		xmlrpc.h

Repository files navigation

------------------------------------------------------------------------
Notes on Steve's for of mod_virgule:

This is not the "classic" mod_virgule code. Mod_virgule classic was
used to run Advogato.org from it's creation until Oct 1, 2006. I created
this fork for my robots.net website and have maintained it since about 2000.
On Oct 1, 2006, Advogato was transitioned to this codebase as well. So I 
think this version is at least "semi-official" at this point. :-)

The main difference is that this code is much closer to being usable
out of the box for a new site. There are no hard coded references to URLs
or site names, etc. Everything like that can be configured in a handy XML
file at run time.  Here are a few of the other improvements found in this
codebase over the original mod_virgule:

-RSS 2.0 support
-FOAF support
-Built-in RSS/Atom aggregator
-Person pages are template based
-Diary pages are template based
-Project pages are template based
-User accounts may be deleted by the administrator
-A built in admin page now exists
-Function names now follows Apache module guidelines
-Compiles against Apache 2.0 (roughly based on James Henstridge's patch)
-User list is configurable, paged, and sorted by cert level
-Article index page is a configurable template
-The sitemap (main navigation menu) is configurable instead of hard-coded.
-Forgotten password feature (based on Steve Kemp's patch)
-Headers include link elements for RSS discovery (James Henstridge's patch)
-Compiles against current libxml2 (Martijn van Beers' libxml2 patch)
-Usernames may have spaces, dashes, underscores, and dots
-Articles can have topic/icons like slash or scoop sites
-Article titles are links to articles
-Headers include link element for favicons
-RSS exports 15 (the RSS max) rather than 10 headlines
-User account page has consistent, easy to read menu layout
-Users cannot certify themselves
-Project list is alphabetized
-Improved, detailed diagnostic info on test page
-Posting, replying, and project creation authorized independently based
user certification level
-Comments added to code to explain purpose
-Several compiler warnings fixed
-Underlying code now has the ability to delete as well as add db entries
-Removed certs are actually deleted
-Removed project relations are actually deleted
-XML tag for an externally updated field

Features that have also been integrated into the "official" codebase:
-Permalinks for diary entries
-Usernames are passed to Apache and logged
-Configurable pass-through directories
-XML tag that renders differently based on user login state
-Code to prevent duplicate replies to articles
-External CSS used to configure color scheme
-External CSS used to configure cert colors
-Cert levels are configurable
-Trust metric seeds are configurable
-Removed much illegal HTML
-DoS vulnerability in cookie parsing fixed


What follows is the original mod_virgule readme file
------------------------------------------------------------------------

This is mod_virgule, the source code to Advogato,
http://www.advogato.org/ . I am releasing it under GPL with the hope
that members of the free software community will:

* Enhance Advogato.

* Develop mod_virgule as a generic tool for creating community web
  sites.

* Learn from mod_virgule's design and implementation, which is unusual
  in a number of respects.

mod_virgule is implemented as an Apache C module, using gnome-xml to
store the state as a XML files in the filesystem. There is an
abstraction layer, however, which means that using a different backend
(such as a "real" database) should be possible.

Right now, there's quite a bit of stuff in the C code that's specific
to Advogato. A medium-term goal is to push most of that stuff into the
XML, so the code itself is more generic. There are a fair number of
core changes here, so it's probably not a good place to hack in
without coordinating with me.

Raph Levien
13 Nov 1999

Development continues slowly. There's a new canonical home for
mod_virgule in ghostscript cvs. You can access it thus:

cvs -z3 -d:pserver:anonymous@cvs.ghostscript.com:/cvs/mod_virgule login
[just press 'enter' if asked for a password]
cvs -z3 -d:pserver:anonymous@cvs.ghostscript.com:/cvs/mod_virgule \
	checkout mod_virgule

There's also a discussion mailing list (virgule-dev) hosted at zork.net.
You can sign up in the usual way, or visit the web interface at

http://zork.net/mailman/listinfo/virgule-dev

Happy Hacking,
rillian
2002 March 25