Diff for "TechDocs/Blogs"

Differences between revisions 13 and 32 (spanning 19 versions)
Revision 13 as of 2010-08-30 12:15:07
Size: 10391
Editor: anonymous
Comment: we can aggregate any RSS feed, not just blogs.fsfe.org
Revision 32 as of 2023-10-09 13:33:07
Size: 7115
Editor: tommi
Comment: replace broken link
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Fellowship Blogs = = FSFE Blogs =
Line 3: Line 3:
The Fellowship blogging platform is available at http://blogs.fsfe.org. We also aggregate blogs of Fellows who will on the [[http://planet.fsfe.org/|Planet]] available in several languages. The FSFE has a blogging platform for volunteers/teams available at https://blogs.fsfe.org/USERNAME.

If you want, you can also have your blog added to the
[[http://planet.fsfe.org/|FSFE Planet]] available in several languages (see below) and visible at https://blogs.fsfe.org.


This wikipage has some basic instructions to use your blog, please read it carefully.
Line 7: Line 13:
To start your blog, just login with your Fellow username and password at To start your blog, just login with your username and password at
Line 9: Line 15:
{{{http://blogs.fsfe.org/USERNAME}}} blog will be automatically created. If you are not familiar with Wordpress, please see the [[#usage|usage instructions]] section below for useful information. {{{http://blogs.fsfe.org/USERNAME}}} blog will be automatically created.

Then you can administrate it at https://blogs.fsfe.org/USERNAME/wp-admin/

The blogging platform is implemented with
[[http://www.wordpress.org|Wordpress]], configured in
''multisite'' mode; this means that some blog features are limited, compared to
a classic stand-alone Wordpress installation (for example, plugins and themes
must be installed in a centralised way, see below).

If you are new to Wordpress and want to learn more, some useful starting points are:
  * http://codex.wordpress.org/New_To_WordPress_-_Where_to_Start
  * http://codex.wordpress.org/WordPress_Lessons

If you are new to blogging, here's a good introductive article:
  * http://codex.wordpress.org/Introduction_to_Blogging

= Blogs usage =

Here you'll find some tips for using your blog.
Line 19: Line 45:
== Get your blog into the Planet ==

The [[http://planet.fsfe.org/|Fellowship Planet]] is an aggregation tool that publishes blog posts from our fellows. There is a planet for different languages: [[http://planet.fsfe.org/|English]], [[http://planet.fsfe.org/de|German]], [[http://planet.fsfe.org/fr|French]], [[http://planet.fsfe.org/es|Spanish]], etc.

If you want to get into this planet, please send an email to <fellowship-hackers AT fsfeurope DOT org> with the following information,

    * RSS feed for the language category, http://blogs.fsfe.org/USERNAME/?feed=rss2&cat=CATEGORY-ID. Note that you can play with the options to have a little more explicit RSS URL. If you are already using an external blogging platform, we can certainly add that RSS feed instead of your fellowship blog.
    * The name under which you would like your blog to be published.
    * Your Hackergotchi, in 80×80 px and PNG format


== Create your hackergotchi ==

A [[http://en.wikipedia.org/wiki/Hackergotchi|Hackergotchi]] is a picture of your head. If you don't have one, here is an [[http://www.linux.com/archive/articles/61131|howto with the GIMP]]. And if you need some inspiration take a look at [[http://planet.gnome.org/heads/|Gnome’s hackergotchi heads]], [[http://planet.kde.org/|planet kde]], [[http://planet.debian.org/|planet debian]], or other planets.


Finally, if you want to help us to improve the blogging platform, have a look
at the [[FellowshipHacks/Projects/Blog]] project.

Any questions, or suggestions? Please write to <<MailTo(fellowship AT fsfeurope DOT org)>>.


----

<<Anchor(usage)>>
== Basic usage ==

The Fellowship blogging platform is based on [[http://www.wordpress.org|Wordpress]] (actually [[http://mu.wordpress.org|Wordpress-mu]], the multi-user version of Wordpress).

If you are new to Wordpress and want to learn more, some useful starting points are:
  * http://codex.wordpress.org/New_To_WordPress_-_Where_to_Start
  * http://codex.wordpress.org/WordPress_Lessons

If you are new to blogging, here's a good introductive article:
  * http://codex.wordpress.org/Introduction_to_Blogging

The Wordpress version installed is the latest 2.7 version, you can find some info on the new features in Wordpress 2.7 at:

  * http://codex.wordpress.org/Version_2.7
  * http://wpmututorials.com/news/wpmu-version-27-is-released-an-overview-upgrade-tips/
  * http://ocaoimh.ie/2009/01/28/wordpress-mu-27/

Please be aware that, since we are using the Wordpress-mu (multi-user) version,
some features of your blog are limited, compared to a classic stand-alone
Wordpress installation (for example, plugins must be installed in a centralised way, see below).


If you already know Wordpress(-mu) (or even hacked on it!) and you have any suggestions about possible improvements to the platform, just write to the same address!
Line 71: Line 49:
Currently we have two Wordpress themes available Currently the following Wordpress themes are available:
Line 73: Line 51:
  * Default: the standard FSFE Fellowship theme
    * If you want to help us improving it, please see [[FellowshipHacks/Projects/Blog/ThemeFellowship]]
  
  * Alternate: this is a customised version of the [[http://wordpress.org/extend/themes/atahualpa|Atahualpa]] wordpress theme
    * If you want to help us improving it, please see [[FellowshipHacks/Projects/Blog/ThemeFellowshipAlternate]]
  * [[FellowshipHacks/Projects/Blog/ThemeFellowshipPome|The "Pome" wordpress theme]]
  * [[FellowshipHacks/Projects/Blog/ThemeFellowshipClassic|The "Classic Green" wordpress theme]]
  * [[FellowshipHacks/Projects/Blog/ThemeFellowshipAtahualpa|The "Atahualpa" wordpress theme]]
Line 79: Line 55:
== Use the official colours of FSFE ==

 * You can find the official FSFE colours and other designer guidelines on the [[https://fsfe.org/contribute/designers/styleguide.en.html|designer section]] of the website.
Line 84: Line 63:
<<MailTo(fellowship AT fsfeurope DOT org)>>
(please note that not all Wordpress plugins are compatible with Wordpress-mu).
<<MailTo(blog-hackers AT lists DOT fsfe DOT org)>>
(please note that not all Wordpress plugins are compatible with the multiuser feature).
Line 87: Line 66:
You can manage plugins in the `Plugins` section of your blog administration dashboard.

Here is a list of currently available plugins:
You can enable/disable plugins in the '''Plugins''' section of your blog administration dashboard.
Line 92: Line 69:
  * spam karma 2
    * http://mu.wordpress.org/forums/tags.php?tag=sk2
    * http://mu.wordpress.org/forums/tags.php?tag=anti-spam
    * http://unknowngenius.com/blog/wordpress/spam-karma/
== Create your hackergotchi ==
Line 97: Line 71:
  * identi.ca tools: http://vikingisaverb.com/ A [[https://fedoraproject.org/wiki/Hackergotchi|Hackergotchi]] is a picture of your head. If you don't have one, here is an [[http://www.linux.com/archive/articles/61131|howto with the GIMP]]. And if you need some inspiration take a look at [[http://planet.gnome.org/heads/|Gnome’s hackergotchi heads]], [[http://planet.kde.org/|planet kde]], [[http://planet.debian.org/|planet debian]], or other planets.
Line 99: Line 73:
  * !AddThis: http://www.addthis.com/
  
  * Sociable: http://yoast.com/wordpress/sociable/
  
  * Social Bookmark Creator: http://www.twistermc.com/shake/wordpress-social.php
  
  * Wordpress.com Stats: http://wordpress.org/extend/plugins/stats/
  
  * Wordpress PDA & iPhone: http://imthi.com/wp-pda/
  
  * WP-Stats-Dashboard: http://wordpress.org/extend/plugins/wp-stats-dashboard/
  
  * WP-Syntax: http://wordpress.org/extend/plugins/wp-syntax/

== Get your blog into the FSFE Planet ==

The [[http://planet.fsfe.org/|Planet]] is an aggregation tool that publishes blog posts from our supporters. There is a planet for different languages: [[http://planet.fsfe.org/|English]], [[http://planet.fsfe.org/de|German]], [[http://planet.fsfe.org/fr|French]], [[http://planet.fsfe.org/es|Spanish]], etc.

If you want to get into this planet, please send an email to <<MailTo(contact AT fsfe DOT org)>> with the following information:

    * RSS feed for the language category, http://blogs.fsfe.org/USERNAME/?feed=rss2&cat=CATEGORY-ID. Note that you can play with the options to have a little more explicit RSS URL. If you are already using an external blogging platform, we can certainly add that RSS feed instead of your blog.
    * Optionally: Your Hackergotchi, in 80×80 px and PNG format

=== Some notes about categories ===

There are no common or "agreed" categories for languages across the planet or in the blogging platform. Instead, you assign a category of your choosing to represent each of your blogging languages, and then you include the numeric identifier of that category in the URL sent to the mail address above. To find out what the identifier is in Wordpress, just look for the category in the list of categories displayed alongside your posts and see what the hyperlink contains. Indeed, just copying that link, which will look like this...

{{{
http://blogs.fsfe.org/USERNAME/?cat=CATEGORY-ID
}}}

...and adding `&feed=rss2` to the end of it will give you a usable URL for the planet.

If you are already blogging to one of the planets and didn't use a language category to start with, but you then find yourself wanting to blog in another language, you can create a language category and then assign it to many of your existing posts at once in the Wordpress authoring interface. To do the latter update, choose the "Posts" section of the interface, select as many as you need to change, choose "Edit" from the "Bulk Actions" menu and click "Apply", and then select your new language category. Finally, click "Update" to add the category to the selected posts. (This is described in the [[http://codex.wordpress.org/Posts_Screen|documentation]] for the "Posts" screen.)

After updating the categorisation of your posts, you will need to tell the Planet maintainers the updated URL for your language-specific posts using the mail address given above.

<<Anchor(spam)>>
== Fight spam ==

To fight spam in your blog comments, we provide some wordpress antispam
plugins: you can test them and use the one(s) you prefer.

 * [[http://blogspam.net/|blogspam]]
   * A free collaborative antispam service
   * See instructions here: http://blogspam.net/plugins/
 * [[http://www.polepositionmarketing.com/library/wordpress-plugins/wpspam-free/|wpspam-free]]
   * This plugin only allows comments from users who have javascript and cookies enabled
   * See instructions here: http://www.polepositionmarketing.com/library/wordpress-plugins/wpspam-free/#wpsf_installation_instructions
 * [[http://wordpress.org/extend/plugins/akismet/|Akismet]]
   * Another collaborative antispam service; you'll need to request an API key (this is free for personal non-commercial use!)
 * [[http://unknowngenius.com/blog/wordpress/spam-karma/|spam karma 2]]
   * This plugin is not actively maintained anymore (so you could get some warning messages), but it still does quite a good job.

If you have other antispam suggestions please let us know!
Line 115: Line 118:

<<Anchor(migration)>>
== Migration from the old portal ==

All Fellowship blogs hosted on the [[OldPortal|old Fellowship portal]] have been migrated
to the new blogging platform; the migration procedure was almost completely automatic, but there are some aspects to be checked or managed manually, see below for details.

All links pointing to blogs, posts and RSS feeds of the old blogging platform are automatically redirected to the corresponding data on the new platform.

You can see your migrated blog at: {{{http://blogs.fsfe.org/USERNAME}}}, and
log into your administration dashboard at:
{{{http://blogs.fsfe.org/USERNAME/wp-admin/}}} (with your usual Fellowship
username and password).

=== Things to check ===

The following data have been automatically migrated, and don't need any action (just check that everything is OK and if you spot anything strange, please write to <<MailTo(fellowship AT fsfeurope DOT org)>>)

  * Blog name
  * Blog posts
  * Comments/trackbacks to posts
  * Images/files hosted on the Fellowship portal and linked inside blog posts (these have been mirrored and no manual migration will be needed)

A note about post licenses: the licensing information for each post doesn't yet appear, but it won't be discarded (it's recorded in our database); we are currently testing some Wordpress plugins to manage blog and posts licenses and we will automatically update the license information for old migrated posts when we have chosen the best solution.

=== Things needing possible fix ===

The following data have been migrated, but might need some manual fixes, because of some differences between the old and new platforms (and some limitations of the migration procedure):

  * '''Blog description''': while the old system allowed for free-form (possibly complex and long) descriptions, the new platform typically has one-sentence descriptions (appearing under the blog name, at the top of your blog pages). Only the first sentence of the existing blog descriptions have been migrated: in most cases that's OK, but in some cases (if you had a long text), you must fix the description in the {{{Settings -> General}}} menu of the administration dashboard, and perhaps add your long description to the default ''About'' page created for each blog (you can add and edit them in the {{{Pages}}} section of your blog administration dashboard).

  * '''Post categories''': while the old system only has one kind of categories, the new system (Wordpress) has two kinds: ''categories'' and ''tags''; the main difference is that ''categories'' can be arranged hierarchically in a tree, while ''tags'' can't. The automatic migration procedure has turned the old system ''categories'' into Wordpress ''categories'' (you can see them listed in the sidebar). This could be fine, for example if you have a short number of well defined categories; but if you have a lot of them, which should really be ''tags'' instead of categories, there's an easy way to transform ''categories'' into ''tags'': just log into your admin dashboard and go to {{{Tools -> Import -> Categories and Tags Converter}}} (you can also do the conversion the other way round, if you change your mind later :-)).

  * The '''HTML markup''' elements allowed in the blog posts are slightly different; you might find some problems if you used some particular markup elements in your posts; here you are a list and some suggestions:
    * A known problem: {{{<br />}}} elements inside {{{<pre>}}} blocks don't get rendered as line breaks (as you 'd expect); you can replace the {{{<br />}}} elements with real line breaks, or, depending on the context, replace the {{{<pre>}}} element with {{{<code>}}} or {{{<blockquote>}}}.
    * If you have to include code examples in your posts, possibly including angular brackets ({{{<}}},{{{>}}}), use the {{{<xmp>...</xmp>}}} element.

  * If you had '''more than one blog''' in the old system (yes some of you dared :) )
    * All posts from all your blogs have been migrated to your new blog (in the new system each Fellow can have only one blog); you can assign different tags or categories to these posts.
    * Your new blog's name and description are those of ''the last'' blog you created, so if this is not OK, please fix them in the {{{Settings -> General}}} administration menu.

  * '''Non-post content''': all items different from standard blog posts have not been migrated, and should be manually moved to the new blogging or wiki platforms. The OldPortal page has detailed instructions about migrating these items.
Category/FellowshipServices

FSFE Blogs

The FSFE has a blogging platform for volunteers/teams available at https://blogs.fsfe.org/USERNAME.

If you want, you can also have your blog added to the FSFE Planet available in several languages (see below) and visible at https://blogs.fsfe.org.

This wikipage has some basic instructions to use your blog, please read it carefully.

Getting Started

To start your blog, just login with your username and password at http://blogs.fsfe.org/wp-login.php, and the http://blogs.fsfe.org/USERNAME blog will be automatically created.

Then you can administrate it at https://blogs.fsfe.org/USERNAME/wp-admin/

The blogging platform is implemented with Wordpress, configured in multisite mode; this means that some blog features are limited, compared to a classic stand-alone Wordpress installation (for example, plugins and themes must be installed in a centralised way, see below).

If you are new to Wordpress and want to learn more, some useful starting points are:

If you are new to blogging, here's a good introductive article:

Blogs usage

Here you'll find some tips for using your blog.

Tags, Categories and Languages

Organizing the content of your blog is important if you want people to find easily what they’re interested in. Tags also give your audience a clear idea of what you’re talking about precisely. However, you might be confused between tags and categories. Well, you’re not the only one in that case.

Moreover, we aren’t all English speakers, and most of us want to blog both in English and in our mother tongue.

So we came up with a quite simple solution. Tags are used to carry content, subjects, whereas Categories are used for languages (and if you want you can also use categories for classification).

Themes

Currently the following Wordpress themes are available:

Use the official colours of FSFE

  • You can find the official FSFE colours and other designer guidelines on the designer section of the website.

Plugins

Wordpress plugins must be installed centrally by the system administrator, then each blogger can decide to enable them on his blog. So if you want to use a particular plugin, write to <blog-hackers AT lists DOT fsfe DOT org> (please note that not all Wordpress plugins are compatible with the multiuser feature).

You can enable/disable plugins in the Plugins section of your blog administration dashboard.

Create your hackergotchi

A Hackergotchi is a picture of your head. If you don't have one, here is an howto with the GIMP. And if you need some inspiration take a look at Gnome’s hackergotchi heads, planet kde, planet debian, or other planets.

Get your blog into the FSFE Planet

The Planet is an aggregation tool that publishes blog posts from our supporters. There is a planet for different languages: English, German, French, Spanish, etc.

If you want to get into this planet, please send an email to <contact AT fsfe DOT org> with the following information:

  • RSS feed for the language category, http://blogs.fsfe.org/USERNAME/?feed=rss2&cat=CATEGORY-ID. Note that you can play with the options to have a little more explicit RSS URL. If you are already using an external blogging platform, we can certainly add that RSS feed instead of your blog.

  • Optionally: Your Hackergotchi, in 80×80 px and PNG format

Some notes about categories

There are no common or "agreed" categories for languages across the planet or in the blogging platform. Instead, you assign a category of your choosing to represent each of your blogging languages, and then you include the numeric identifier of that category in the URL sent to the mail address above. To find out what the identifier is in Wordpress, just look for the category in the list of categories displayed alongside your posts and see what the hyperlink contains. Indeed, just copying that link, which will look like this...

http://blogs.fsfe.org/USERNAME/?cat=CATEGORY-ID

...and adding &feed=rss2 to the end of it will give you a usable URL for the planet.

If you are already blogging to one of the planets and didn't use a language category to start with, but you then find yourself wanting to blog in another language, you can create a language category and then assign it to many of your existing posts at once in the Wordpress authoring interface. To do the latter update, choose the "Posts" section of the interface, select as many as you need to change, choose "Edit" from the "Bulk Actions" menu and click "Apply", and then select your new language category. Finally, click "Update" to add the category to the selected posts. (This is described in the documentation for the "Posts" screen.)

After updating the categorisation of your posts, you will need to tell the Planet maintainers the updated URL for your language-specific posts using the mail address given above.

Fight spam

To fight spam in your blog comments, we provide some wordpress antispam plugins: you can test them and use the one(s) you prefer.

If you have other antispam suggestions please let us know!


Category/FellowshipServices

TechDocs/Blogs (last edited 2023-10-09 13:33:07 by tommi)