community-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n...@apache.org
Subject svn commit: r1035497 - in /comdev/site: branches/ trunk/ trunk/cgi-bin/ trunk/content/ trunk/content/localmentors.mdtext trunk/lib/ trunk/lib/path.pm trunk/lib/view.pm trunk/templates/ trunk/templates/standard.html
Date Tue, 16 Nov 2010 00:02:36 GMT
Author: nick
Date: Tue Nov 16 00:02:36 2010
New Revision: 1035497

URL: http://svn.apache.org/viewvc?rev=1035497&view=rev
Log:
Start on cms powered comdev site. Includes a single page converted from cwiki, the auto-export
template converted to DTL, and supporting path/view libraries

Added:
    comdev/site/branches/
    comdev/site/trunk/
    comdev/site/trunk/cgi-bin/
    comdev/site/trunk/content/
    comdev/site/trunk/content/localmentors.mdtext
    comdev/site/trunk/lib/
    comdev/site/trunk/lib/path.pm
    comdev/site/trunk/lib/view.pm
    comdev/site/trunk/templates/
    comdev/site/trunk/templates/standard.html

Added: comdev/site/trunk/content/localmentors.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/localmentors.mdtext?rev=1035497&view=auto
==============================================================================
--- comdev/site/trunk/content/localmentors.mdtext (added)
+++ comdev/site/trunk/content/localmentors.mdtext Tue Nov 16 00:02:36 2010
@@ -0,0 +1,62 @@
+Title: /home/nick/tmp/LocalMentors.cwiki
+The Local Mentors project aims to allow people getting started in Apache (both within the
[Formal Mentoring Program](mentoringprogramme.html), and everyone else) to meet up with existing
Apache developers in their area.
+
+# Why?
+
+When you're getting involved in a new open source project, it can be a little daunting. You
engage in the mailing lists with people from all around the world. You solve bugs with people
in different time zones. You develop patches with people from different languages and cultures.
Perhaps you have a mentor ([Formal](mentoringprogramme.html) or informal) from your project,
but the chances area, they're a thousand miles away.
+
+This global reach is some of where open source derives its power from. However, for many
people approaching it for the first time, it can present an odd challenge.
+
+No matter which project you're involved in, there may well be some things that you're finding
a little different or difficult that are specific to where you are. Perhaps you'd like some
tips on making the best use of the time zone difference between yourself and a couple of the
main developers on the project? Perhaps English isn't your first language, and you'd like
to double check some points of technical language that are leading to confusion? Perhaps you'd
like to chat over some of the cultural differences that you've spotted? Or maybe you've just
spent a lot of time communicating about open source electronically, and you'd really like
to see a real face for once\!
+
+That's where the local mentor project steps in. Find an existing Apache committer near you,
head to a cafe or pub, grab a coffee or a beer, and have a chat. They probably won't know
your project, but they'll hopefully know the rest\!
+
+
+# If you're looking for a local mentor
+
+First up, make sure a local mentor's the right thing for you. The Local Mentoring project
has different aims to the [Formal Mentoring Program](mentoringprogramme.html). If you're after
someone who knows your project, or someone who's available over a prolonged period of time,
then the [Formal Mentoring Program|MentoringProgramme] is a better fit.
+
+However, if you'd like to meet up with someone to put a friendly face on the ASF, and discuss
open source and Apache from where you are, hopefully in your own language, then this might
be the right thing for you.
+
+  
+  
+
+To find a local mentor, please visit [http://community.zones.apache.org/](http://community.zones.apache.org/)
+
+  
+  
+
+Using [http://community.zones.apache.org/](http://community.zones.apache.org/), you simply
need to enter your location, and search for Apache committers willing to act as local mentors
near you. Drop them an email to introduce yourself. However, please remember that they will
be giving up their time to meet and help you, so you'll almost certainly need to work to their
location and availability\!
+
+While Apache has committers in almost all corners of the world, not all of them are currently
part of the local mentoring program. As such, you might discover that you can't find anyone
near you. In that case, either look for people near where you might visit in the future, or
failing that, see if any other open source foundations or local groups have anything near
you.
+
+# How existing Apache Committers can get involved
+
+If you think you could spare the odd hour everyone once in a while, to sit down over a beer
or a coffee and chat about Open Source and the Apache Way, then we'd love you to get involved\!
You're not signing up to a long-term mentoring relationship (see the [Formal Mentoring Program](mentoringprogramme.html)
if you're interested in that though) Just every so often, helping out someone who lives near
you.
+
+Firstly, you'll need a FOAF entry on people.apache.org. Take a look at [http://people.apache.org/foaf/](http://people.apache.org/foaf/)
for instructions on setting this up if you haven't already done so. Next, ensure that you
have listed your location - we need that to be able to let people search for you.
+
+Now, if you haven't already done so, checkout the committers directory from svn:
+
+    svn co https://svn.apache.org/repos/private/committers/
+
+
+Edit *local-outreach/CommunityDevelopment.rdf* and add yourself in as a helper. If your FOAF
file is in svn and showing up on people.apache.org, add in:
+
+    <helper>
+    <foaf:Person rdf:resource="urn:org:apache:[your username].rdf" />
+    </helper>
+
+If you have your FOAF file externally hosted, then the * rdf:resource * should point to the
URL of the file.
+
+For an apache committer with username "foo", your entry would be one of:
+
+    <helper>
+    <foaf:Person rdf:resource="urn:org:apache:foo.rdf" />
+    </helper>
+    <helper>
+    <foaf:Person rdf:resource="http://www.example.com/foaf/foo.rdf" />
+    </helper>
+
+
+Within 24 hours of committing your addition to *local-outreach/CommunityDevelopment.rdf*,
you should appear in the web application\! Head over to [http://community.zones.apache.org/](http://community.zones.apache.org/)
a day later a check you're listed properly

Added: comdev/site/trunk/lib/path.pm
URL: http://svn.apache.org/viewvc/comdev/site/trunk/lib/path.pm?rev=1035497&view=auto
==============================================================================
--- comdev/site/trunk/lib/path.pm (added)
+++ comdev/site/trunk/lib/path.pm Tue Nov 16 00:02:36 2010
@@ -0,0 +1,32 @@
+package path;
+
+# All our pages use the same view function
+our @patterns = (
+    [qr!^/.*\.html$!,   normal_page => {} ],
+    [qr!^/.*\.mdtext$!, normal_page => { template=>"standard.html" } ],
+);
+
+# for specifying interdependencies between files
+our %dependencies = ();
+
+1;
+
+=head1 LICENSE
+
+           Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+
+             http://www.apache.org/licenses/LICENSE-2.0
+
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+

Added: comdev/site/trunk/lib/view.pm
URL: http://svn.apache.org/viewvc/comdev/site/trunk/lib/view.pm?rev=1035497&view=auto
==============================================================================
--- comdev/site/trunk/lib/view.pm (added)
+++ comdev/site/trunk/lib/view.pm Tue Nov 16 00:02:36 2010
@@ -0,0 +1,86 @@
+package view;
+
+#
+# BUILD CONSTRAINT:  all views must return $content, $extension.
+# additional return values (as seen below) are optional.  However,
+# careful use of symlinks and dependency management in path.pm can
+# resolve most issues with this constraint.
+#
+
+use strict;
+use warnings;
+use Dotiac::DTL qw/Template/;
+use Dotiac::DTL::Addon::markup;
+use ASF::Util qw/read_text_file shuffle/;
+use File::Temp qw/tempfile/;
+use LWP::Simple;
+
+push @Dotiac::DTL::TEMPLATE_DIRS, "templates";
+
+# This is most widely used view.  It takes a
+# 'template' argument and a 'path' argument.
+# Assuming the path ends in foo.mdtext, any files
+# like foo.page/bar.mdtext will be parsed and
+# passed to the template in the "bar" (hash)
+# variable.
+sub normal_page {
+    my %args = @_;
+    my $file = "content$args{path}";
+    $args{path} =~ s/\.mdtext$/\.html/;
+    $args{breadcrumbs} = breadcrumbs($args{path});
+
+    my $template = $file;
+    if($args{template}) {
+       $template = $args{template};
+    }
+
+    read_text_file $file, \%args;
+
+    my $page_path = $file;
+    $page_path =~ s/\.[^.]+$/.page/;
+    if (-d $page_path) {
+        for my $f (grep -f, glob "$page_path/*.mdtext") {
+            $f =~ m!/([^/]+)\.mdtext$! or die "Bad filename: $f\n";
+            $args{$1} = {};
+            read_text_file $f, $args{$1};
+        }
+    }
+
+    return Dotiac::DTL::Template($template)->render(\%args), html => \%args;
+}
+
+# Generates cwiki-style breadcrumbs
+sub breadcrumbs {
+    my @path = split m!/!, shift;
+    pop @path;
+    my @rv;
+    my $relpath = "";
+    for (@path) {
+        $relpath .= "$_/";
+        $_ ||= "Home";
+        push @rv, qq(<a href="$relpath">\u$_</a>);
+    }
+    return join "&nbsp;&raquo&nbsp;", @rv;
+}
+
+1;
+
+=head1 LICENSE
+
+           Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+
+             http://www.apache.org/licenses/LICENSE-2.0
+
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+

Added: comdev/site/trunk/templates/standard.html
URL: http://svn.apache.org/viewvc/comdev/site/trunk/templates/standard.html?rev=1035497&view=auto
==============================================================================
--- comdev/site/trunk/templates/standard.html (added)
+++ comdev/site/trunk/templates/standard.html Tue Nov 16 00:02:36 2010
@@ -0,0 +1,117 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+
+<html>
+    <head>
+       <META name="description" content="Apache Community Development"/>
+       <META name="keywords" content="apache, apache community, community development,
opensource"/>
+
+		
+	   <META http-equiv="Content-Type" content="text/html; charset=utf-8">
+   	   <LINK rel="stylesheet" href="style/compressed.css" type="text/css" media="screen,
projection">
+       <LINK rel="stylesheet" href="style/style.css" type="text/css" media="screen, projection">
+	   <style type="text/css">
+.code {
+	border: 1px dashed #3c78b5;
+	font-size: 11px;
+	font-family: Courier;
+	margin: 10px;
+	margin-left: 0px;
+	line-height: 13px;
+}
+.codeHeader {
+	background-color: #f0f0f0;
+	border-bottom: 1px dashed #3c78b5;
+	padding: 3px;
+	text-align: center;
+}
+.codeContent {
+	text-align: left;
+	background-color: #f0f0f0;
+	padding: 3px;
+}
+
+.preformatted {
+	border: 1px dashed #3c78b5;
+	font-size: 11px;
+	font-family: Courier;
+	margin: 10px;
+	line-height: 13px;
+}
+.preformattedHeader {
+	background-color: #f0f0f0;
+	border-bottom: 1px dashed #3c78b5;
+	padding: 3px;
+	text-align: center;
+}
+.preformattedContent {
+	background-color: #f0f0f0;
+	padding: 3px;
+}
+        </style>
+
+        <LINK rel="SHORTCUT ICON" href="$images/favicon.ico">   
+        <TITLE>Apache Community Development - {% block title %}{{ headers.title }}{%
endblock %}</TITLE>
+    </head>
+
+    <body onload="init()">
+    	<div class="container">
+    	<HR class="space col">
+    	<DIV class="block">
+    		<DIV class="column span-24">
+            <DIV id="header">
+                <h1>The Apache Software Foundation<BR />
+                <SPAN class="alt"><small>Meritocracy in Action.</small></SPAN></h1>
+             </DIV>
+          </DIV>
+    	</DIV>
+    	<HR/>
+
+
+        <TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
+            <TR class="topBar">
+                <td align="left" valign="middle" class="topBarDiv" nowrap="true" width="100%">
+                    &nbsp;{{ breadcrumbs }}
+                </td>
+                <td align="right" valign="middle" class="topBarDiv" align="left" nowrap="true">
+                    <A href="http://community.apache.org">Apache Community Development</A>
| <A href="http://mail-archives.apache.org/mod_mbox/community-dev/">Mailling List</A>
+                </td>
+            </TR>
+        </TABLE>
+
+        <TABLE border="0" cellpadding="0" width="100%">
+            <TR>
+                <td align="left" valign="top">
+                  <DIV id="PageContent">        
+                     <DIV class="pagecontent">
+                         <DIV class="wiki-content">
+                          {% block content %}{{ content|markdown }}{% endblock %}
+                         </DIV>
+                     </DIV>
+                  </DIV>
+                </td>
+            </TR>
+        </TABLE>
+
+        <DIV class="footer">
+            Copyright © 2003-2009, The Apache Software Foundation&nbsp;&nbsp;
+        </DIV>
+
+    </BODY>
+</HTML>



Mime
View raw message