[opensuse-marketing] openSUSE Theme for Jekyll Blogs
Hi all, A few weeks ago I finally got rid of my old wordpress blogs and replaced it with something more 2016, the Jekyll static site generator https://jekyllrb.com/ I've put together an openSUSE theme for Jekyll https://github.com/sysrich/beautiful-jekyll-opensuse For people who don't want to bother setting anything up, Jekyll can be used directly with github pages - The README covers how to fork the theme and set it up on minutes. Jekyll isn't quite as easy as wordpress to live with, but it is a lot more secure, a lot faster, and I'm using it as an opportunity to practice my 'git' skills, which are becoming increasingly important for contributing to lots of different parts of our project, not just developer ones. You can see the theme in action on http://rootco.de Credit to Dean Attali for the original theme, and our own awesome Cynthia & Zvesdana for their work on www.opensuse.org which was surprisingly easy to merge into this theme. Remember, if you have a personal blog, please make sure it's aggregated on http://planet.opensuse.org - the openSUSE community is interested in whatever crazy (or not crazy) stuff you are up to. All you need to do is add it to https://github.com/openSUSE/planet.opensuse.org/blob/master/planetsuse/feeds which you can do via a github pull request, or email admin@opensuse.org Regards, -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi El 05/04/16 a las 18:36, Richard Brown escribió:
Hi all,
A few weeks ago I finally got rid of my old wordpress blogs and replaced it with something more 2016, the Jekyll static site generator
I've put together an openSUSE theme for Jekyll
I really like that theme! It's simple, and beautiful!!
For people who don't want to bother setting anything up, Jekyll can be used directly with github pages - The README covers how to fork the theme and set it up on minutes.
Jekyll isn't quite as easy as wordpress to live with, but it is a lot more secure, a lot faster, and I'm using it as an opportunity to practice my 'git' skills, which are becoming increasingly important for contributing to lots of different parts of our project, not just developer ones.
You can see the theme in action on http://rootco.de
Great stuff there!! ;)
Credit to Dean Attali for the original theme, and our own awesome Cynthia & Zvesdana for their work on www.opensuse.org which was surprisingly easy to merge into this theme.
Remember, if you have a personal blog, please make sure it's aggregated on http://planet.opensuse.org - the openSUSE community is interested in whatever crazy (or not crazy) stuff you are up to.
I did it! :þ
All you need to do is add it to https://github.com/openSUSE/planet.opensuse.org/blob/master/planetsuse /feeds
which you can do via a github pull request, or email
admin@opensuse.org
Regards,
've phun!! - -- GPG Key: 0xC9B7E22A Aprende a proteger la privacidad de tu correo: https://emailselfdefense.fsf.org/es/ -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBAgAGBQJXA/X/AAoJEMx0Lo3Jt+Iqm7gP/2Rw2ia74UVcmfCtSUYD201/ MheA2oEOpB0R0yIEPddeWHcmD6kHgpBGgTNQcUXohaNfwi6Y/Hk7pj/fMCxH3mcN 67IN1aStBF7oYfIg1BXirdLY8rR4Zw1U1f/2e83+rYXoAWt3Vwi/VF85/Po8zZwu tB3FV9/kpykq962vPAN/PlNCpBIIlvyR93woelbP7Tcz19E0G/OkbaXFK/6KgevE Uqbqk9WRTF9nU66A2KhFwXvg09tduqS44mcnpVS7MLX7V9KjqXg7G7aQoZulnCLZ kVB7XaOWOf9efpY/WBatTzIWWpsCxV08AmjS5l4A2Xyv43U19wqMNFmX3E70bOgW VwN5a+i9scT04XskNkLAKDR3Z31v/N+XfhfT6rZwa4bfuyxisp3NBW/QLQ2abCCP 4vaxlA7nESOiIMBQqHd1DcfaCx1SC3YGc7A8W522IQWChe0TyvTd9p8EJZm8Hyqp S3wLvOXOp6wv6Bvmgs76Yv0XET8Ohs6LpfVvDoWkmVrDFYKSktjkxrlpSOUQxeZM s6oUQUL0HmLzQUUqTknqnnCJGqgJeweIhrE/jh1+divpwQ3CTuiYdVsrqKhnZ1EH NTri8LX6qGTEiAsHzej86m3Q6DMRIaj/aX82rGYWq9Q7aaIJ1AkDdN4Uxx165nAT JVXZCWd/AYz+KqC2l+bs =7RSe -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Hi Richard, On 04/05/2016 08:36 PM, Richard Brown wrote:
A few weeks ago I finally got rid of my old wordpress blogs and replaced it with something more 2016, the Jekyll static site generator
I've wanted to replace my WP blog since a long time, I've just been so lazy with the content migration.
I've put together an openSUSE theme for Jekyll
That's a great theme. Simple & very openSUSE-like. :) Thanks for sharing. Cheers, -- Ish Sookun - Advocating openSUSE since 2010 :) - I blog at HACKLOG.mu Try openSUSE, https://www.opensuse.org -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Le 10/04/2016 08:55, Ish Sookun a écrit :
Jekyll static site generator
hello, As often, the jekyll site is developer friendly but not user friendly... 1) do you have a link to a way of knowing how one can really *use* jekyll to write a blog or web site? (I want to write, what do I have to do) 2) github hosting is said to be free, but is it sure it wont become like sourceforge, full of pubs? 3) how are done the updates? I not even understand if jekyll is run on the desktop or on the server thanks jdd -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Hi jdd, On 04/10/2016 11:18 AM, jdd wrote:
1) do you have a link to a way of knowing how one can really *use* jekyll to write a blog or web site? (I want to write, what do I have to do)
I'm running Jekyll on openSUSE Leap 42.1. You'll need gcc & make. Then fire up: gem install jekyll It does not put the symbolic link, let's do it manually: ln -s /usr/bin/jekyll.ruby2.1 /usr/local/bin/jekyll To create a "project", do: jekyll create my-web-project jekyll serve & The output should look like: Configuration file: /home/ish/my-web-project/_config.yml Source: /home/ish/my-web-project Destination: /home/ish/my-web-project/_site Incremental build: disabled. Enable with --incremental Generating... done in 17.329 seconds. Auto-regeneration: enabled for '/home/ish/my-web-project' Configuration file: /home/ish/my-web-project/_config.yml Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop. I also tried a WP migration and it appeared to be straight-forward with "jekyll-import". You'll also need the following "sequel", "unidecode", "mysql". gem install sequel unidecode mysql jekyll-import The following snippet will import the WordPress posts into the Jekyll project: ruby -rubygems -e 'require "jekyll-import"; JekyllImport::Importers::WordPress.run({ "dbname" => "wordpress", "user" => "wpadmin", "password" => "xxxxxx", "host" => "localhost", "socket" => "", "table_prefix" => "wp_", "site_prefix" => "", "clean_entities" => true, "comments" => true, "categories" => true, "tags" => true, "more_excerpt" => true, "more_anchor" => true, "extension" => "html", "status" => ["publish"] })' Cheers, -- Ish Sookun - Advocating openSUSE since 2010 :) - I blog at HACKLOG.mu Try openSUSE, https://www.opensuse.org -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
On dimanche, 10 avril 2016 14.13:00 h CEST Ish Sookun wrote:
Hi jdd,
On 04/10/2016 11:18 AM, jdd wrote:
1) do you have a link to a way of knowing how one can really *use* jekyll to write a blog or web site? (I want to write, what do I have to do)
I'm running Jekyll on openSUSE Leap 42.1. You'll need gcc & make. Then fire up: gem install jekyll
It does not put the symbolic link, let's do it manually:
ln -s /usr/bin/jekyll.ruby2.1 /usr/local/bin/jekyll
To create a "project", do:
jekyll create my-web-project jekyll serve &
The output should look like:
Configuration file: /home/ish/my-web-project/_config.yml Source: /home/ish/my-web-project Destination: /home/ish/my-web-project/_site Incremental build: disabled. Enable with --incremental Generating... done in 17.329 seconds. Auto-regeneration: enabled for '/home/ish/my-web-project' Configuration file: /home/ish/my-web-project/_config.yml Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop.
I also tried a WP migration and it appeared to be straight-forward with "jekyll-import". You'll also need the following "sequel", "unidecode", "mysql".
gem install sequel unidecode mysql jekyll-import
The following snippet will import the WordPress posts into the Jekyll project:
ruby -rubygems -e 'require "jekyll-import"; JekyllImport::Importers::WordPress.run({ "dbname" => "wordpress", "user" => "wpadmin", "password" => "xxxxxx", "host" => "localhost", "socket" => "", "table_prefix" => "wp_", "site_prefix" => "", "clean_entities" => true, "comments" => true, "categories" => true, "tags" => true, "more_excerpt" => true, "more_anchor" => true, "extension" => "html", "status" => ["publish"] })'
Cheers,
Thanks Ish for the information. Now for me my main concern will be how to migrate lizards wp where I can't have mysql db connection :-) On board report, I'm seeing that lizards will close (unfortunately, but understable). And contact will be made with author to help on migration. I certainly have to wait until this happen. -- Bruno Friedmann Ioda-Net Sàrl www.ioda-net.ch openSUSE Member, fsfe fellowship GPG KEY : D5C9B751C4653227 irc: tigerfoot -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Le 10/04/2016 14:44, Bruno Friedmann a écrit :
Now for me my main concern will be how to migrate lizards wp where I can't have mysql db connection :-)
I use pmwiki, that don't need any database http://www.pmwiki.org/ I could move my previous wordpress account texts, but manually (copy and paste) http://dodin.info/wiki/pmwiki.php?n=Bavardages.Bavardages there are blog-like plugins, but I don't see any reason for the fuss jdd -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
On 10 April 2016 at 14:44, Bruno Friedmann <bruno@ioda-net.ch> wrote:
On dimanche, 10 avril 2016 14.13:00 h CEST Ish Sookun wrote:
Hi jdd,
On 04/10/2016 11:18 AM, jdd wrote:
1) do you have a link to a way of knowing how one can really *use* jekyll to write a blog or web site? (I want to write, what do I have to do)
I'm running Jekyll on openSUSE Leap 42.1. You'll need gcc & make. Then fire up: gem install jekyll
It does not put the symbolic link, let's do it manually:
ln -s /usr/bin/jekyll.ruby2.1 /usr/local/bin/jekyll
To create a "project", do:
jekyll create my-web-project jekyll serve &
The output should look like:
Configuration file: /home/ish/my-web-project/_config.yml Source: /home/ish/my-web-project Destination: /home/ish/my-web-project/_site Incremental build: disabled. Enable with --incremental Generating... done in 17.329 seconds. Auto-regeneration: enabled for '/home/ish/my-web-project' Configuration file: /home/ish/my-web-project/_config.yml Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop.
I also tried a WP migration and it appeared to be straight-forward with "jekyll-import". You'll also need the following "sequel", "unidecode", "mysql".
gem install sequel unidecode mysql jekyll-import
The following snippet will import the WordPress posts into the Jekyll project:
ruby -rubygems -e 'require "jekyll-import"; JekyllImport::Importers::WordPress.run({ "dbname" => "wordpress", "user" => "wpadmin", "password" => "xxxxxx", "host" => "localhost", "socket" => "", "table_prefix" => "wp_", "site_prefix" => "", "clean_entities" => true, "comments" => true, "categories" => true, "tags" => true, "more_excerpt" => true, "more_anchor" => true, "extension" => "html", "status" => ["publish"] })'
Cheers,
Thanks Ish for the information.
Now for me my main concern will be how to migrate lizards wp where I can't have mysql db connection :-) On board report, I'm seeing that lizards will close (unfortunately, but understable). And contact will be made with author to help on migration. I certainly have to wait until this happen.
Don't worry, Lizards' wont be going anywhere until everyone currently on it has found a new home But if you want to get ahead of things by moving now, awesome :) Do lizards users have access to the Wordpress > Tools > Export tool? If so, you can use that and this variation on what Ish posted above to import from one of those wordpress.xml exports https://import.jekyllrb.com/docs/wordpressdotcom/ -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
On dimanche, 10 avril 2016 15.42:22 h CEST Richard Brown wrote:
On 10 April 2016 at 14:44, Bruno Friedmann <bruno@ioda-net.ch> wrote:
On dimanche, 10 avril 2016 14.13:00 h CEST Ish Sookun wrote:
Hi jdd,
On 04/10/2016 11:18 AM, jdd wrote:
1) do you have a link to a way of knowing how one can really *use* jekyll to write a blog or web site? (I want to write, what do I have to do)
I'm running Jekyll on openSUSE Leap 42.1. You'll need gcc & make. Then fire up: gem install jekyll
It does not put the symbolic link, let's do it manually:
ln -s /usr/bin/jekyll.ruby2.1 /usr/local/bin/jekyll
To create a "project", do:
jekyll create my-web-project jekyll serve &
The output should look like:
Configuration file: /home/ish/my-web-project/_config.yml Source: /home/ish/my-web-project Destination: /home/ish/my-web-project/_site Incremental build: disabled. Enable with --incremental Generating... done in 17.329 seconds. Auto-regeneration: enabled for '/home/ish/my-web-project' Configuration file: /home/ish/my-web-project/_config.yml Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop.
I also tried a WP migration and it appeared to be straight-forward with "jekyll-import". You'll also need the following "sequel", "unidecode", "mysql".
gem install sequel unidecode mysql jekyll-import
The following snippet will import the WordPress posts into the Jekyll project:
ruby -rubygems -e 'require "jekyll-import"; JekyllImport::Importers::WordPress.run({ "dbname" => "wordpress", "user" => "wpadmin", "password" => "xxxxxx", "host" => "localhost", "socket" => "", "table_prefix" => "wp_", "site_prefix" => "", "clean_entities" => true, "comments" => true, "categories" => true, "tags" => true, "more_excerpt" => true, "more_anchor" => true, "extension" => "html", "status" => ["publish"] })'
Cheers,
Thanks Ish for the information.
Now for me my main concern will be how to migrate lizards wp where I can't have mysql db connection :-) On board report, I'm seeing that lizards will close (unfortunately, but understable). And contact will be made with author to help on migration. I certainly have to wait until this happen.
Don't worry, Lizards' wont be going anywhere until everyone currently on it has found a new home
But if you want to get ahead of things by moving now, awesome :)
Do lizards users have access to the Wordpress > Tools > Export tool?
If so, you can use that and this variation on what Ish posted above to import from one of those wordpress.xml exports
Nope unfortunately we don't have this export tools as normal user on lizards.o.o Perhaps we can have them, or some volunteers to export on request ? -- Bruno Friedmann Ioda-Net Sàrl www.ioda-net.ch openSUSE Member, fsfe fellowship GPG KEY : D5C9B751C4653227 irc: tigerfoot -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Le 10/04/2016 12:13, Ish Sookun a écrit :
Hi jdd,
On 04/10/2016 11:18 AM, jdd wrote:
1) do you have a link to a way of knowing how one can really *use* jekyll to write a blog or web site? (I want to write, what do I have to do)
I'm running Jekyll on openSUSE Leap 42.1. You'll need gcc & make. Then fire up: gem install jekyll
it's not the question. I can find install instruction, but first I guess this have to be installed on my desktop, not in my server? your instructions are not totally exact, there is no "create" but "build", but it's not important. If I create a file "file.txt" in the source folder, it's simply copied in the target folder. It's not what I call a "generator" https://jekyllrb.com/docs/posts/ this is not what I want. Presently I use a wiki that allows me to write texts with minimal syntax and have it displayed asap thanks jdd -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
On 10 April 2016 at 14:46, jdd <jdd@dodin.org> wrote:
your instructions are not totally exact, there is no "create" but "build", but it's not important.
If I create a file "file.txt" in the source folder, it's simply copied in the target folder. It's not what I call a "generator"]
This isn't how Jekyll works at all..
This is a correct link that describes the actual behaviour of Jekyll, I'm confused how you make the above statement when the documentation clearly says the opposite "All posts must have YAML Front Matter, and they will be converted from their source format into an HTML page that is part of your static site." To give an example using my blog You can see the source of my entire blog, it's theme, it's config, and it's posts, on [Github](https://github.com/sysrich/rootco.de-web) I have copies of this git repo on all of my machines, which I synchronise using `git pull` When I want to write a new blog post, I create a file called `$date-$title.md` eg. 2016-04-04-opensuse-and-you.md I then write the post using the simple Markdown language https://daringfireball.net/projects/markdown/basics This language is pretty wonderful. It's easy to learn, it's easy to use, there are lots of editors that understand the language and can help you (automatic syntax highlighting in gedit and vim for example). Unlike many other markup languages (eg. HTML) it is also very easy to read even before it has been converted into something else. To prove this point, I have written this entire email using the Markdown format ;) The post needs to have a few lines of information at the start, this is what the Jekyll docs call the YAML Front Matter. Taking the example from my recent 'Why You Should Use Tumbleweed' post, this is basically two or three lines (the `date:` is optional) in between two lines with 3 dashes `---` That tells Jekyll the title of the blog post and what kind of layout to use (normally `layout: post`)
--- layout: post title: Why You Should Use Tumbleweed date: '2016-03-28 19:05:02' ---
Then you write the blog post. You can see the full markdown used for the 'Why You Should Use Tumbleweed' post here: https://raw.githubusercontent.com/sysrich/rootco.de-web/master/_posts/2016-0... When `jekyll build` runs in my `rootco.de-web` folder on my machine, it takes the markdown file in `_posts` and creates a totally new html file in `_site` It is this `_site` folder which I upload to my website, where you can see the nice generated output http://rootco.de/2016-03-28-why-use-tumbleweed/ I actually automate the whole thing using git, so I work on my laptop/desktop, `git commit` it there, `git push` it back to GitHub, then my server actually as a cron job which automatically does a `git pull` from GitHub, runs Jekyll, and puts the `_site` folder in the `/srv/www/htdocs` folder of my Apache2 server. But that is an advanced topic I wouldn't worry about if you just want to get started with Jekyll, because GitHub can do all of that for you All you need to do to get started is have a Github account - https://github.com/join Whatever you pick as your username will end up being part of your blogs URL * Then login. * Go to https://github.com/sysrich/beautiful-jekyll-opensuse * Click on 'Fork' in the top right hand corner * Then go to 'Settings' and rename the Repository Name to "yourusername.github.io" * Then, using the Text Editor available in the GitHub WebUI, you can edit the _config.yml file for your blog to change it's settings and set it up the way you like * Then, using the buttons available in the GitHub WebUI, you can make your `_posts` folder and make your first `$date-$title.md` file like I described above * Then, using the text editor in the GitHub WebUI you can start writing your blog post You don't need to run this on an openSUSE machine to get started. You don't need to do fancy stuff like me and Ish. Github will automatically do all the Jekyll build and blah for you.. you don't need to install anything, you don't need to configure much..it really couldn't be much easier to get started All of this is documented, including an animated video of the steps I list above, in the original link to the beautiful-jekyll-openSUSE theme https://github.com/sysrich/beautiful-jekyll-opensuse/blob/master/README.md Does this help? -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Le 10/04/2016 15:37, Richard Brown a écrit :
This isn't how Jekyll works at all..
well I wished what you explain (pretty well) in your mail be explained on the jekyll site. This would have prevented me from using it :-) I think a simple wiki like pmwiki much easier. No database, no git account, any web site accessible with ftp http://www.pmwiki.org/wiki/PmWiki/Installation untar the archive and you are done. the markup is a variant of markdown, simpler than mediawiki one that you need to know for our wiki, and like for our wiki, the only markup one really need is than one have to let a blank line between two paragraphs... this is even simpler than reading your mail (or mine, by the way :-) that is why I tested jekyll with an empty text file. a "generator" should have done better than a copy. I myself use what can be called "a very raw simple web site generator" that takes anything (usually jpg) in a folder and makes an html page from it: #!/bin/sh # written in Fev 11, 2007 by Jean-Daniel Dodin # feel free to use at will # this script takes a list of files and # makes an html page with links to them #file="liste.html"; file="index.html"; echo "<html><body>" > $file; for I ; do echo $I echo -n "<a href=\"" >> $file ; echo -n "$I" >> $file ; echo -n "\">" >> $file; echo -n "$I" >> $file; echo -n "</a><br />" >> $file; echo >> $file; done ; echo -n "</body></html>" >> $file; result: http://dodin.org/temp/index.html I'm sure any programmer can do a better code, but this one works thanks, you could be a great teacher, your post was really clear :-) jdd -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
On 10 April 2016 at 16:20, jdd <jdd@dodin.org> wrote:
Le 10/04/2016 15:37, Richard Brown a écrit :
This isn't how Jekyll works at all..
well I wished what you explain (pretty well) in your mail be explained on the jekyll site. This would have prevented me from using it :-)
I think a simple wiki like pmwiki much easier. No database, no git account, any web site accessible with ftp
http://www.pmwiki.org/wiki/PmWiki/Installation
untar the archive and you are done.
the markup is a variant of markdown, simpler than mediawiki one that you need to know for our wiki, and like for our wiki, the only markup one really need is than one have to let a blank line between two paragraphs...
this is even simpler than reading your mail (or mine, by the way :-)
that is why I tested jekyll with an empty text file. a "generator" should have done better than a copy.
When you feed Jekyll something other than markdown files, Jekyll just copies That's a good thing - that's exactly what you want it to do when you want your site generator to deal with other file formats I use that feature for uploading images and presentations to my server. Your wiki might make sense for your own personal use cases, but for me it would be greatly deficient Compared to Jekyll pmwiki has the following missing features - Solid Themeing - Blog post handling (I don't want to have to micro-manage 'articles' in a wiki) - Handling of different filetypes (Copying is good) - Simple blog-like RSS Feeds - Essential if I want my blog to be listed on planet.opensuse.org Each to their own, but the reason I'm sharing this is that it is a nice, relatively simple, reusable, pretty, openSUSE themed blogging option -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
Le 10/04/2016 17:01, Richard Brown a écrit :
Each to their own, but the reason I'm sharing this is that it is a nice, relatively simple, reusable, pretty, openSUSE themed blogging option
no problem, everybody use what fills better his needs :-) jdd -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org
participants (5)
-
Bruno Friedmann
-
Ish Sookun
-
jdd
-
Richard Brown
-
victorhck