[gentoo-commits] gentoo commit in xml/htdocs/proj/en/userrel/planet: admin.xml index.xml

[gentoo-commits] gentoo commit in xml/htdocs/proj/en/userrel/planet: admin.xml index.xml

[Theo Chatzimichos (tampakrap)]

tampakrap    10/10/18 17:19:23

  Modified:             index.xml
  Added:                admin.xml
  Log:
  Major update in planet docs:Added admin page with instructions for planet/blogs administratorsAdded terms and better instructions for bug requests

Revision  Changes    Path
1.7                  xml/htdocs/proj/en/userrel/planet/index.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?rev=1.7&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?rev=1.7&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?r1=1.6&r2=1.7

Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- index.xml	2 May 2010 01:17:14 -0000	1.6
+++ index.xml	18 Oct 2010 17:19:23 -0000	1.7
@@ -4,9 +4,9 @@
 <!DOCTYPE project SYSTEM "/dtd/project.dtd">
 
 <project>
-<name>planet</name>
+<name>Planet</name>
 <longname>Planet Gentoo</longname>
-<date>2009-03-31</date>
+<date>2010-10-17</date>
 
 <author title="Author">
   <mail link="christel@gentoo.org">Christel Dahlskjær</mail>
@@ -27,75 +27,105 @@
 
 <p>
 We run a service, <uri link="http://planet.gentoo.org">Planet Gentoo</uri>, which
-aggregates articles written by contributing developers. This is optional, but it
-is encouraged that you participate. It helps communication between developers and
-users find it to be an interesting read too.
+aggregates articles written by contributing developers. This is optional, but any
+developer is encouraged to participate. It helps communication between developers,
+and users find it to be an interesting read too.
 </p>
 
 <p>
-In order to post content to the planet, you need to have your own weblog
-("blog"). Many sites provide this as a free service, or you can host it
-yourself (if you have the resources). Alternatively, we can host a blog for
-you.
+While Planet is strictly Gentoo-themed, an additional service runs to cover any
+non Gentoo related posts, called <uri link="http://planet.gentoo.org/universe">
+Universe</uri>.
 </p>
 
 <p>
-We aim to keep Planet Gentoo's content relevant to Gentoo and/or Gentoo-related
-developments and events.
-</p>
-
-<p>
-If we host your blog for you, you are expected to keep the content on-topic
-(Gentoo and Gentoo-related articles). You also need to understand that if you
-ever lose or drop your developer status, you will no longer be able to write
-articles on your blog.
+In order to post content to Planet/Universe, you need to have your own weblog
+("blog"). Many sites provide this as a free service, or you can host it
+yourself (if you have the resources). Alternatively, we can host a blog for
+you at <uri link="http://blogs.gentoo.org/">Gentoo Developer Blogs</uri>.
 </p>
 
 <p>
-If you have a blog elsewhere, then it needs to be able to provide an XML
-content feed. If you blog into categories, we need to be able to get an XML
-feed which covers your "Gentoo" category but no others. This is probably a
-non-issue, as almost all blogs provide standardised feeds like this.
+If you are interested in contributing to Planet Gentoo, please read the
+<uri link="#doc_chap4">Terms</uri>, and then file a bug providing the relevant
+information needed (more info <uri link="#doc_chap5">here</uri>).
 </p>
 
-<p>
-This aggregation is currently available in two forms. Planet Gentoo shows only
-posts marked
-as 'on-topic', and related to Gentoo development.
- <uri link="http://planet.gentoo.org/universe">Gentoo Universe</uri> shows
-all posts to that developer's blog, for those who are interested in more
-than strictly Gentoo-related news.
-</p>
+</longdescription>
 
-<p>
-Although this is somewhat common sense, please be careful with what you write
-about. Your views may be inappropriately interpreted as the views of Gentoo.
-Please be careful not to damage our image.
-</p>
+<extrachapter>
+<title>Terms</title>
+<section>
+<body>
 
-<p>
-If you are interested in contributing to Planet Gentoo, please <uri
-link="https:///bugs.gentoo.org">file a bug</uri>, selecting Product
-<c>Website www.gentoo.org</c> and Component <c>Planet</c>. You'll need
-to provide us your blog link, RSS feed links for Planet and Universe
-and your <uri link="#doc_chap4">gravatar</uri> email, if applicable.
-</p>
+<ul>
+  <li>
+    Blogs at blogs.gentoo.org are provided to Gentoo Developers only, thus if
+    you lose your developer status we'll revoke your access to your blog.
+  </li>
+  <li>
+    The content in blogs.gentoo.org will stay there for archive reasons.
+  </li>
+  <li>
+    Planet posts should be strictly Gentoo related and in English. Universe posts
+  don't have to follow that rule.
+  </li>
+  <li>
+    Please be careful with what you write about. Your views may be inappropriately
+    interpreted as the views of Gentoo. Please be careful not to damage our image.
+  </li>
+  <li>
+    The Gentoo community is consisted of all kinds of people, so please avoid any
+    racist comments.
+  </li>
+  <li>
+    While constructive criticism is welcome, flamewars and attacks towards other
+    projects or people are forbidden.
+  </li>
+  <li>
+    The Planet Gentoo team has the right to ban people from Planet/Universe or
+    suspend authors from Gentoo Developer Blogs that don't follow the above terms.
+  </li>
+</ul>
 
-</longdescription>
+</body>
+</section>
+</extrachapter>
 
 <extrachapter>
-<title>Blog Hosting</title>
+<title>Contact</title>
 <section>
 <body>
 
 <p>
-Using <uri link="http://www.b2evolution.net/">b2evolution</uri>, Planet
-Gentoo hosts blogs for any Gentoo developers who are in need of a home.
-</p>
+To ask for a new blog hosted in blogs.gentoo.org, or to be included in Planet /
+Universe, please make sure you have read the <uri link="#doc_chap4">Terms</uri>,
+and then <uri link="https://bugs.gentoo.org">file a bug</uri>, selecting Product
+<c>Website www.gentoo.org</c> and Component <c>Planet</c>. You'll need to provide
+us the following information:
+</p>
+
+<ul>
+  <li>
+    An RSS feed reflecting your Gentoo category or tag, for Planet posts.
+  </li>
+  <li>
+    Optional: An RSS feed that will reflect wider range of posts, for Universe.
+    An RSS feed that aggregates the whole blog is also acceptable
+  </li>
+  <li>
+    A gravatar mail (see <uri link="#doc_chap6">below</uri> for more info).
+  </li>
+  <li>
+    For a new blog in blogs.gentoo.org, state it clearly in the bug. After that
+    you'll be asked to set up a Gentoo category/tag and a gravatar mail, for
+    Planet / Universe aggregation.
+  </li>
+</ul>
 
 <p>
-If you want a Gentoo hosted blog, please <uri link="https://bugs.gentoo.org">file a bug</uri>,
-selecting Product <c>Website www.gentoo.org</c> and Component <c>Planet</c>.
+Also, you can file a bug in case something is wrong with Planet/Universe/Blogs, or
+in case you want a new plugin/theme added for WordPress.
 </p>
 
 </body>
@@ -112,22 +142,29 @@
 developer on the website.
 </p>
 
-<p>For ease of maintenance, we use gravatars (globally recognized avatars)
+<p>
+For ease of maintenance, we use gravatars (globally recognized avatars)
 which the developer can manage personally.  Users can create their own gravatar
 at <uri>http://www.gravatar.com/</uri>.  By default, the MD5 string we use to
 access the personalized avatars is username@gentoo.org.  If you already have
 an account under a different e-mail address and would like to use that instead,
-please contact a developer to have your configuration updated.</p>
+please contact a developer to have your configuration updated.
+</p>
 
 </body>
 </section>
 </extrachapter>
 
-<dev role="Lead">beandog</dev>
-<dev>tampakrap</dev>
+<dev description="Planet, Blogs">beandog</dev>
+<dev description="Blogs">nightmorph</dev>
+<dev description="Planet, Blogs">tampakrap</dev>
+
 
-<resource link="http://planet.gentoo.org">Planet Gentoo</resource>
-<resource link="http://planet.gentoo.org/universe">Gentoo Universe</resource>
-<resource link="http://blogs.gentoo.org/">Gentoo Developer Blogs</resource>
+<resource link="http://planet.gentoo.org">Website: Planet Gentoo (An aggregation of Gentoo-related weblog articles)</resource>
+<resource link="http://planet.gentoo.org/universe">Website: Gentoo Universe (An aggregation of weblog articles on all topics)</resource>
+<resource link="http://blogs.gentoo.org/">Website: Gentoo Developer Blogs</resource>
+<resource link="admin.xml">Admininstration: Instructions for Planet and Blogs administrators</resource>
+<resource link="http://git.overlays.gentoo.org/gitweb/?=proj/planet-gentoo.git">Administration: Planet Gentoo config files</resource>
+<resource link="http://git.overlays.gentoo.org/gitweb/?=proj/blogs-gentoo.git">Administration: Gentoo Blogs plugins/themes</resource>
 
 </project>



1.1                  xml/htdocs/proj/en/userrel/planet/admin.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?rev=1.1&content-type=text/plain

Index: admin.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v 1.1 2010/10/18 17:19:23 tampakrap Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<guide>
<title>Planet and Blogs administration</title>

<author title="Author">
  <mail link="tampakrap" />
</author>

<abstract>
Instructions for Planet and Blogs administrators
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.0</version>
<date>2007-12-09</date>

<chapter>
<title>Introduction</title>
<section>
<title>Planet configuration files</title>
<body>

<p>
The software that powers Planet and Universe is <uri link="http://intertwingly.net/code/venus/">
Venus</uri>. It consists of the python code, a config file (which consists of the
site info and the list of the users aggregated) and the theme. It then parses the
feed URLs and creates a static HTML page. Planet and Universe configs are stored in
a git repository. The configs include the venus software configs, the Gentoo theme
for venus, and the configs with the users. The git repository is <uri
link="http://git.overlays.gentoo.org/gitweb/?p=proj/planet-gentoo.git">here</uri>.
A more detailed explanation about its structure:
</p>

<ul>
  <li>
    archives: contains the index.php files that create and show the archives html files
  </li>
  <li>
    configs: the actual venus config files. the scripts/update-venus cron job
    merges all the files in that dir into two big files, one for planet and one
    for universe, named venus.{planet,universe}.ini
    <ul>
      <li>
        base/: site information
      </li>
      <li>
        planet/ universe/: each user's information
      </li>
    </ul>
  </li>
  <li>
    media: static css and image files 
  </li>
  <li>
    scripts: 
    <ul>
      <li>
        adduser.py: helper script to add new user
      </li>
      <li>
        gravatar.py: produces email md5 as requested by gravatar
      </li>
      <li>
        update-venus: the cron job that updates the site content,
      </li>
    </ul>
  </li>
  <li>
    templates: the gentoo venus theme    
  </li>
</ul>

<p>
In case you want to perform a local install for testing, the following steps
are sufficient:
</p>

<ul>
  <li>
    emerge -av venus
  </li>
  <li>
    webapp-config -I -h blogs.gentoo.org venus version
  </li>
  <li>
    git clone git://git.overlays.gentoo.org/proj/planet-gentoo.git
    /var/www/planet.gentoo.org/
  </li>
  <li>
    sh /var/www/planet.gentoo.org/planet-gentoo/scripts/update-venus
    (This will create the necessary symlinks and create the appropriate configs
    for planet)
  </li>
</ul>

</body>
</section>
<section>
<title>Blogs configuration</title>
<body>

<p>
The software that powers Gentoo Blogs is <uri link="http://wordpress.org">
WordPress</uri>, using its <uri link="http://codex.wordpress.org/Create_A_Network">
Network</uri> feature to support multiple blogs in a single installation.
Furthermore, we store the wp-content/{plugins,themes} dirs in a <uri 
link="http://git.overlays.gentoo.org/gitweb/?p=proj/planet-gentoo.git">git
repository</uri>, so that blogs admins can easily install/update them.
</p>

<p>
The WP Network supports a Super Admin, who can enable / disable plugins, create
/ delete users and blogs. Furthermore, each user can also be an admin of his own
blog (or more than one). Any configuration (users, blogs, permissions, plugins
etc) will be done through the admin web panel, which you can enter by typing
http://blogs.gentoo.org/wp-admin (for the topdir's one), or 
http://blogs.gentoo.org/$user/wp-admin to enter someone else's admin panel
(which you should avoid).
</p>

</body>
</section>
</chapter>
<chapter>
<title>Adding Users</title>
<section>
<title>...in planet</title>
<body>

<p>
To add a new user in planet, either create the config by hand (under
configs/{planet,universe}/nickname) or use the adduser.py script. Always check
the results of the script before committing your changes though.
</p>

</body>
</section>
<section>
<title>...in blogs</title>
<body>

<p>
Go to Super Admin panel -> Sites, and scroll to the bottom of the page
where the Add Site form is. Fill in the blanks, and the system will create
a new blog, and if the admin email doesn't exist (which should not), a new
user with the same name as the blog will be created. The user will get an
email with his password.
</p>

</body>
</section>
</chapter>
<chapter>
<title>Removing Users</title>
<section>
<title>...from planet</title>
<body>

<p>
To remove a user from planet/universe, just git rm his config(s)
</p>

</body>
</section>
<section>
<title>...from blogs</title>
<body>

<p>
We NEVER delete content from blogs.g.o. What should be done is to set a new
random password at his account. (Super Admin -> Users)
</p>

<impo>The above actions should be taken either by a user request, or when
the planet team is CC'd at a developer retirement bug</impo>

</body>
</section>
</chapter>
</guide>

[gentoo-commits] gentoo commit in xml/htdocs/proj/en/userrel/planet: admin.xml index.xml

[Theo Chatzimichos (tampakrap)]

tampakrap    11/05/18 08:18:59

  Modified:             admin.xml index.xml
  Log:
  Update blogs instructions

Revision  Changes    Path
1.4                  xml/htdocs/proj/en/userrel/planet/admin.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?r1=1.3&r2=1.4

Index: admin.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- admin.xml	1 Nov 2010 22:26:59 -0000	1.3
+++ admin.xml	18 May 2011 08:18:59 -0000	1.4
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v 1.3 2010/11/01 22:26:59 tampakrap Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v 1.4 2011/05/18 08:18:59 tampakrap Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide>
@@ -17,8 +17,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.0</version>
-<date>2007-12-09</date>
+<version>1.1</version>
+<date>2011-05-18</date>
 
 <chapter>
 <title>Introduction</title>
@@ -146,8 +146,8 @@
 <body>
 
 <p>
-Go to Super Admin panel -> Sites, and scroll to the bottom of the page
-where the Add Site form is. Fill in the blanks, and the system will create
+Go to https://blogs.gentoo.org/wp-admin/network/ -> Sites -> Add New on the
+left menu. Fill in the blanks, and the system will create
 a new blog, and if the admin email doesn't exist (which should not), a new
 user with the same name as the blog will be created. The user will get an
 email with his password.



1.9                  xml/htdocs/proj/en/userrel/planet/index.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?rev=1.9&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?rev=1.9&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?r1=1.8&r2=1.9

Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- index.xml	1 Nov 2010 22:14:48 -0000	1.8
+++ index.xml	18 May 2011 08:18:59 -0000	1.9
@@ -181,7 +181,7 @@
 </extrachapter>
 
 <dev description="Planet, Blogs">beandog</dev>
-<dev description="Blogs">nightmorph</dev>
+<dev description="Planet, Blogs">nightmorph</dev>
 <dev description="Planet, Blogs">tampakrap</dev>
 
 

[gentoo-commits] gentoo commit in xml/htdocs/proj/en/userrel/planet: admin.xml index.xml

[Andreas HAttel (dilfridge)]

dilfridge    15/03/14 16:56:23

  Modified:             admin.xml index.xml
  Log:
  Moved to wiki

Revision  Changes    Path
1.5                  xml/htdocs/proj/en/userrel/planet/admin.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?rev=1.5&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?rev=1.5&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml?r1=1.4&r2=1.5

Index: admin.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- admin.xml	18 May 2011 08:18:59 -0000	1.4
+++ admin.xml	14 Mar 2015 16:56:22 -0000	1.5
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v 1.4 2011/05/18 08:18:59 tampakrap Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/admin.xml,v 1.5 2015/03/14 16:56:22 dilfridge Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
-<guide>
+<guide disclaimer="obsolete" redirect="http://wiki.gentoo.org/wiki/Project:Planet/Administration">
 <title>Planet and Blogs administration</title>
 
 <author title="Author">



1.11                 xml/htdocs/proj/en/userrel/planet/index.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?rev=1.11&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?rev=1.11&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml?r1=1.10&r2=1.11

Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/userrel/planet/index.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- index.xml	21 May 2013 20:57:50 -0000	1.10
+++ index.xml	14 Mar 2015 16:56:22 -0000	1.11
@@ -3,7 +3,7 @@
 <?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
 <!DOCTYPE project SYSTEM "/dtd/project.dtd">
 
-<project>
+<project disclaimer="obsolete" redirect="http://wiki.gentoo.org/wiki/Project:Planet">
 <name>Planet</name>
 <longname>Planet Gentoo</longname>
 <date>2010-10-17</date>