[samba-soc] project blogs

[Gerald (Jerry) Carter]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Project blogs are up and running.  We're still tweaking things
but you can get a general feel for things.  Here's the howto.


Project Blogs
=============

Project blogs are published at http://projects.samba.org/

To start blogging about your code, first check out the
PROJECTS branch from the samba-blog svn repository:

$ svn co \
~        svn+ssh://svn.samba.org/data/svn/samba-blog/branches/PROJECTS \
~        projects

the projects/index.html contains a list of current available
and active projects.  Simply add you project to the existing html
table (following the existing format).

Now create a new directory in the appropriate branch
folder (e.g. samba3 or samba4).  This is where you will
store all blog entries for your project.

To create a new blog entry, just add a new file to the
project directory you just created and give the file and
extension of .blog.  Since this the blogging script (bloxsom)
is very low maintenance and low-tech, it will not track any
author information so you should probably sign you name to
the entry somehow.

The format of blog files is simple ASCII text (although
you can embed html links if you like).  The first line in
the file is the entry title and paragraphs (i.e. <p>) are
divi died by a blank line.  The name of the file is arbitrary
but it is probably a good idea to use the date of entry
somehow such as month-day-year (e.g. jul-19-05.blog)

Here's an simple example:

- ------ file contents --------------------------
Registry futures in Samba 3.0:

I posted a few links to some ideas for making better use of the Registry
API earlier today.

<ul>
~   <li><a
href="http://lists.samba.org/archive/samba-technical/2005-July/041912.html">Remote
editing of smb.conf via registry calls
</a></li>
~   <li><a
href="http://lists.samba.org/archive/samba/2005-July/108456.html">Implementing
task scheduler for Samba 3</a></li>
</ul>

jerry
- ------ file contents --------------------------


Publishing
==========

New blogs entries are synchronized from the svn repos every 10
minutes.  The ordering of blog entries is cached into an index
file based on the first time the file is seen by the bloxsom
scripts.  So you can edit files later if you like without
disturbing the entry order.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.0 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFC3Q0+IR7qMdg1EfYRAsycAJ4u6DH/2tNs1b/g83nwSNnsNztI1ACdHwmI
W0fyNz4lT2XuvIbm9hKf1ig=
=H7Qm
-----END PGP SIGNATURE-----