Difference between revisions of "Planet"

Revision as of 09:16, 11 January 2020

See also: Website and Community links

Planet is a stream of the latest the posts from Hackspace related blogs, it can be found at here.

Getting started

If you blog about Hackspace relevant stuff, you’d be most welcome to contribute your feed to Planet Nottinghack. If you already run a blog its RSS feed can be sent to Planet; collecting everyone's latest posts into one place.

It's relatively easy to add your blog; see below.

Setting up a blog

It is easy to set up a blog. For example, Wordpress .com is popular and can be fed into Planet, see wordpress.com.

Also, contributions to the Newsletter are welcome. The wiki can also be used to write about your project, for example Les Plywood and Fire Pong.

Adding your blog

It's relatively easy to add your blog in, but requires a little bit of technical work. If you need help ask the Communications team.

GitHub

Nottinghack's Website github repository contains the list of blogs and code for Planet:

../planet/nottinghack/ - contains config file for details of bloggers
../public_planet/heads/ - contains the head icons

You will need to fork our website repository on GitHub, make changes, add your image and then issue a pull request back to us. If this sounds complicated, don't worry - it isn't! If you already know how to use github, you can fork the repo and skip to the next section...

Forking

First, head over to GitHub and make yourself an account.
Second, visit the website github and click the "Fork" button - this copies the repository into your account.
You need to get to your area, so click on the octocat icon at the top left. You will see "Your Repositories" on the right of the new page, with your copy of our repo in it. Click on this link.
We now need to make two changes to the repository:

Add blog image

You need a blog image that is 65 pixels wide, and between about 50 and 90 pixels high. It should also have a transparent background and be saved as a PNG. There are many tutorials on the web to help you do this, and free tools such as [http://www.gimp.org/ GIMP} available. Name it after yourself. Good examples of this image are:

78 pixels high
55 pixels high
73 pixels high

Navigate to public_planet/heads (in your fork of the website) and add your image here. You can do this in browser by clicking the small + next to the path. Make sure your filename doesn't clash with any others.

Add blog to list

Navigate to planet/nottinghack (in your fork of the website) and open the config.ini file. At the bottom of this file add a blank line and then the following code, replacing the parts in

<Angle Brackets>

with your information:

[<Address to your blog's RSS feed>]
name = <Your Name>
face = <filename of your image>
faceheight = <pixel height of your image>

Submit a pull request

Once you have committed all your changes, you need to issue a pull request. From your repository, click on "Pull Requests" on the right, then "Create a Pull Request". You will see a list of all changes you are sending, then click the big green button.

One of the Web Editors will review your request and merge it with the main branch. After that, the Planet updates every 12 hours, so will pull your latest blog post the next time is refreshes.

@@ Line 2: / Line 2: @@
 {{also|Website|Community links}}
-'''Planet''' is a stream of the latest blog posts by people who have opted in.
+'''Planet''' is a stream of the latest the posts from Hackspace related blogs, it can be found at [http://planet.nottinghack.org.uk/ here].
+==Getting started==
+If you blog about Hackspace relevant stuff, you’d be most welcome to contribute your feed to Planet Nottinghack. If you already run a blog its RSS feed can be sent to Planet; collecting everyone's latest posts into one place.
-==
+It's relatively easy to add your blog; see below.
-If you blog about hackspace relevant stuff, you’d be most welcome to contribute your feed to Planet Nottinghack. Many members run their own blogs, & this automatically uses RSS to collect them all into one place: http://planet.nottinghack.org.uk/.
+===Setting up a blog===
+It is easy to set up a blog. For example, Wordpress .com is popular and can be fed into Planet, see [https://wordpress.com wordpress.com].
+Also, contributions to the [[Newsletter]] are welcome. The wiki can also be used to write about your project, for example [[Les Plywood]] and [[Fire Pong]].
+==Adding your blog==
+It's relatively easy to add your blog in, but requires a little bit of technical work. If you need help ask the [[Team:Communications|Communications team]].
+=== GitHub ===
+Nottinghack's [https://github.com/NottingHack/website Website github] repository contains the list of blogs and code for Planet:
+* ../planet/nottinghack/ - contains config file for details of bloggers
+* ../public_planet/heads/ - contains the head icons
-It's relatively easy to add your blog in, but requires a little bit of technical work.
+You will need to fork our website repository on GitHub, make changes, add your image and then issue a pull request back to us.  If this sounds complicated, don't worry - it isn't!  If you already know how to use github, you can fork the repo and skip to the next section...
-===Setting up a blog===
+=== Forking ===
+* First, head over to [http://www.github.com GitHub] and make yourself an account.
+* Second, visit the [https://github.com/NottingHack/website website github] and click the "Fork" button - this copies the repository into your account.
+* You need to get to your area, so click on the octocat [[File:Github.png|20px]] icon at the top left.  You will see "Your Repositories" on the right of the new page, with your copy of our repo in it.  Click on this link.
+* We now need to make two changes to the repository:
-== Blog image ==
+=== Add blog image ===
 You need a blog image that is 65 pixels wide, and between about 50 and 90 pixels high.  It should also have a transparent background and be saved as a PNG.  There are many tutorials on the web to help you do this, and free tools such as [http://www.gimp.org/ GIMP} available.  Name it after yourself. Good examples of this image are:
@@ Line 23: / Line 41: @@
 </gallery>
-== GitHub ==
+Navigate to <code>public_planet/heads</code> (in your fork of the website) and add your image here.  You can do this in browser by clicking the small <code>+</code> next to the path.  Make sure your filename doesn't clash with any others.
-You will need to fork our website repository on GitHub, make changes, add your image and then issue a pull request back to us.  If this sound complicated, don't worry - it isn't!  If you already know how to use github, you can fork the repo and skip to the next section...
+=== Add blog to list ===
-* First, head over to [http://www.github.com GitHub] and make yourself an account.
+Navigate to <code>planet/nottinghack</code> (in your fork of the website) and open the config.ini file.  At the bottom of this file add a blank line and then the following code, replacing the parts in <pre><Angle Brackets></pre> with your information:
-* Now, visit our [https://github.com/NottingHack/website repo] and click the "Fork" button - this copies the repository into your account.
-* You need to get to your area, so click on the octocat icon at the top left.  You will see "Your Repositories" on the right of the new page, with your copy of our repo in it.  Click on this link.
-* We now need to make two changes to the repository:
-=== Add your image ===
-Navigate to <code>public_planet/heads</code> and add your image here.  You can do this in browser by clicking the small <code>+</code> next to the path.  Make sure your filename doesn't clash with any others.
-=== Add your blog ===
-Navigate to <code>planet/nottinghack</code> and open the config.ini file.  At the bottom of this file add a blank line and then the following code, replacing the parts in <pre><Angle Brackets></pre> with your information:
 <pre>
@@ Line 48: / Line 55: @@
 === Submit a pull request ===
 Once you have committed all your changes, you need to issue a pull request.  From your repository, click on "Pull Requests" on the right, then "Create a Pull Request".  You will see a list of all changes you are sending, then click the big green button.
-Someone from the web team will review your request and hopefully merge it with the main branch.  After that, the Planet updates every 12 hours, so will pull your blog in the next time is refreshes.
+One of the [[List of Web Editors|Web Editors]] will review your request and merge it with the main branch. After that, the Planet updates every 12 hours, so will pull your latest blog post the next time is refreshes.
 ==See also==
@@ Line 58: / Line 64: @@
 [[Category:Online Presence]]
 [[Category:Blog]]
+[[Category:Looking for Collaborators]]