https://github.com/gluster/planet-gluster
I Have A Dream, that One Day we will have a Gluster Planet....
https://github.com/gluster/planet-gluster
Last synced: about 1 year ago
JSON representation
I Have A Dream, that One Day we will have a Gluster Planet....
- Host: GitHub
- URL: https://github.com/gluster/planet-gluster
- Owner: gluster
- License: other
- Created: 2015-04-15T12:31:33.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2023-01-28T01:19:37.000Z (over 3 years ago)
- Last Synced: 2025-04-22T21:02:06.742Z (about 1 year ago)
- Language: Haml
- Size: 2.69 MB
- Stars: 3
- Watchers: 10
- Forks: 26
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [Planet Gluster](http://planet.gluster.org) is a blog aggregator.
It is based on [middleman-planet](https://github.com/OSAS/middleman-planet)
which in turn is based on [middleman-springboard](https://github.com/OSAS/middleman-springboard).
It combines the article feeds from several blog and news sites into one web page.
## How to add or remove feeds?
Edit `data/feeds.yml` to add or remove feeds.
Optionally you can add an "avatar" image (png/jpeg/svg) to
`source/images/planet/`. There are no strict restrictions, only that the image
should be roughly square in aspect ratio and 96 pixels or larger in shortest
edge.
If you don't specify an avatar for your feed, a placeholder image is displayed
instead.
#### Example:
```
Joe's Blog:
image: avatar_image_file.png
rounded: false
feed: [feed url]
```
# Middleman-Springboard
Springboard is a starter-pack for Middleman, for quickly whipping together
static-based websites.
To get started, you need to have Ruby and Ruby Gems installed, as well
as "bundler".
## Initial setup
Before you do anything else, remember this:
When you use `middleman-springboard`, remember that sites are a fork of this
repository. Be sure you change your origin before you push. You can do this
automatically when forking this repository.
You can push small changes back upream to this repository, as well as pull in
changes made too — but try to keep forks separate. _Thanks!_
### Fedora, RHEL, & CentOS
```
git clone https://github.com/OSAS/middleman-springboard.git YOUR_PROJECT
cd YOUR_PROJECT
./setup.sh # This script assumes your user account has sudo rights
```
### Other Linux distributions
Currently, `setup.sh` is a super-simple script that only has support for
Fedora, RHEL, and CentOS.
(Pull requests to add support for other distributions and operating systems
are welcome.)
Be sure you have a C++ and Ruby development environment, as well as Ruby Gems
and Bundler, then run the following:
```
git clone https://github.com/OSAS/middleman-springboard.git YOUR_PROJECT
cd YOUR_PROJECT
bundle install
```
## Running a local server
1. Start a local Middleman server:
`./run-server.sh`
This will update your locally installed gems and start a Middleman
development server.
2. Next, browse to
3. Edit!
When you edit files (pages, layouts, CSS, etc.), the site will
dyanmically update in development mode. (There's no need to refresh
the page, unless you get a Ruby error.)
## Customizing your site
The site can be easily customized by editing `data/site.yml`.
## Adding a Post
To add a post to the community blog (or any blog managed by middleman) use:
```
bundle exec middleman article TITLE
```
## Build your static site
After getting it how you want, you can build the static site by running:
`bundle exec middleman build`
## Deploying
### Setting up deployment
FIXME: Right now, please reference
### Actual deployment
After copying your public key to the remote server and configuring your
site in , deployment is one simple command:
```
bundle exec middleman deploy
```
### Add new features (parsers, etc.)
Simply add a new `gem 'some-gem-here'` line in the `Gemfile` and run
`bundle install`
## More info
For more information, please check the excellent
[Middleman documentation](http://middlemanapp.com/getting-started/).