I am working on choosing and adopting a static site generator.
My understanding is that Jekyll is the most popular one. I learned that Jekyll is based on Ruby language.
I do not have any experience with Ruby and it is not on my Career path. I am very much a .NET and C# developer.
Do I need to know Ruby in order to use Jekyll efficiently? Or should I compromise and adopt a less popular static site generator that is based on .NET platform?
Update after having good answers here and some research
I think we have good response and answers here. Thank you #2583rk and #deveth0
However, I am discouraged by the fact that Jekyll disregards Windows and does not provide official support for it. Windows is quite a popular desktop OS and ignoring it does not look good for a tool that usually (and practically) runs on a "non-server" or desktop environment (It does generates files run on servers though)
I am going to give Pretzel a try as it has all the benefits of Jekyll plus more.
There is no need for Ruby understanding. Most task just require a basic or deeper knowledge of markdown and liquid, but both are easy to learn.
Only if you want to build plugins, you'll need Ruby.
I switched my blog over to Jekyll earlier this year with no background in Ruby and, for the most part, it hasn't been a problem. Jekyll is a simple and straightforward solution with some good documentation; you can find a lot of examples online on how to setup it up properly and use plugins without knowing too much about Ruby.
I've been using Jekyll on a Windows laptop without any issues. There's a separate set of instructions for getting it up and running on Windows here. You need to install a package manager called Chocolatey, then install ruby using choco install ruby -y and then you can install Jekyll using gem install jekyll. There's some more detailed information on the link for specific things like encoding, auto-generation, etc.
Jekyll works fine on Windows. Half my doc team is using Jekyll with Windows. Here's a tutorial on installing Jekyll on Windows.
Related
I wanted to learn Jekyll mainly for designing websites and blogs.
What are the necessary required skills that I should have before I can start digging into Jekyll/
Thank you in advance.
Today I learned Jekyll. It's pretty straigt forward!
The minimum prerequisites are knowledge of HTML and CSS. Nice to have but not required before you start is some knowledge about Liquid Jekyll's templating engine.
I used Jekyll's own tutorial, that David already pointed out and read through the first few pages. Then I got hands on with it by following the quick start instructions from their homepage:
gem install jekyll
jekyll new my-awesome-site
cd my-awesome-site
jekyll serve
# => Now browse to http://localhost:4000
Installing it on my Mac worked fine with the pre installed Ruby and its packagemanager RubyGems on my Mac OS X 10.9. I already installed node.js and it's packagemanager npm before, but i haven't seen where it's needed but maybe somewhere under the hood.
From here I inspected the demo package, read a bit in the docs and googled my way through till I had a working site build by Jekyll.
Have fun!
P.S. For the posts and sites I refreshed my knowledge about the markdown syntax.
Well except html, css and javascript, you just have to learn Jekyll itself it's really easy.
Go for it !
I am currently trying to port an Eclipse RCP plugin to RAP (it is my first experience with RAP). I had a look at several sample applications and tutorials on how to port, but all information I have got says that the bundle org.eclipse.core.resources should be available (as long as I don't misinterpret them completely).
I have resolved all other Required-Bundle-errors, but 'Bundle 'org.eclipse.core.resources' cannot be resolved' resides. It seems that org.eclipse.core.resources is not included with the RAP target platform (I installed it via Eclipse and checked the settings).
Is org.eclipse.core.resources not included anymore and if yes, what can I use to replace it? Or how can I include it?
The bundle org.eclipse.core.resources is not part of the RAP target platform, and it never was. The original bundle the Eclipse platform is not suitable for RAP.
To use the resources bundle with RAP, a RAP version would have to be created, that provides per-session workspaces in ResourcePlugin#getWorkspace(). It's technically feasible but probably a fair amount of work.
I knew this day would come, so I guess it is here. (P.S. I am on windows XP).
I am trying to use this program here. I installed it fine, but it doesnt seem to work when I type in equations. So I went back to the site and it says I need JRE version 5.0 or above, (check). Then it also says I need dvipng, which I dont think I have.
So I went to the site it tells me to, (here), and I downloaded the most recent one, "dvipng-1.14.tar.gz". I unzipped it and I have it all sitting in one directory.
Ok... now what?
Im afraid I need guidance on exactly how to proceed here. The readme and installation instructions say to run "./configure", then "make", etc, I opened the command prompt and did all that but doesnt recognize. I have never had to build in this way, I always used an IDE for compiling C++ programs that I write myself. (Anyway, why am I even having to make an exe why dont they just make one and let us download that?)
Very confused as to what I need to do here, appreciate some step by step help.
Thank you
Even though Mohammad's problem was solved in the comments, I'll have a go at answering his question:
To run a build system that uses ./configure, you need something that can run shell scripts, as well as the usual suite of unix tools that the script expects, plus a compiler that behaves in the standard sort of way.
The two projects that I know of that do this are cygwin and MSYS. cygwin is aimed at creating a full POSIX environment on windows, while MSYS is an add-on to MinGW that aims to provide just the parts needed to run a ./configure script and build a program.
After asking this question (XAMPP Mercurial installation on Windows Apache --> HgWebDir.cgi Script Error) and reading though the whole internet including this question (How do I get Mercurial's hgwebdir working on Windows?) and all its links for about 10 hours, I seem to not be able to find a solution. I begun with this tutorial https://www.mercurial-scm.org/wiki/HgWebDirStepByStep ... and I really don't want to install ancient versions of Mercurial. I got my windows-apache to run Python scripts, CGI-Scripts, publish them in the wild, but hgwebdir just won't work.
Question 1:
Can someone please enrich his personal blog with a tutorial on how to install MERCURIAL on a WINDOWS XAMPP installation and make it visible to the world? I guarantee a lot of pageviews, as this is not a trivial problem. And this would sincerely help a lot of other people I guess.
Question 2:
For example, even after browsing half a day through everywhere, I just cannot find out, which version of python I need to pair with the freshest version of mercurial, and I get the "magic number is wrong"-error. This would be my question, if noone has time to make up a nice blogpost. Sorry for being a bit frustrated.
I recently encountered this problem - with the added complication of supporting TortoiseHG. I posted a tutorial on my blog describing how to host multiple Mercurial repositories on a Windows XP machine using XAMPP and TortoiseHG.
http://makinggames.ca/dev/version-control-mercurial-apache-tortoisehg/
Okay, after all it was just a whole lot of directory-location-problems and a big version-problem (needed to use Python 2.6 with Mercurial 1.5.1). Got it working now. If I happen to write a full windows-guide, I'll add a comment.
I want to start doing web development with Eclipse. Not Java, tomcat, axis2, or anything else anymore complicated than basic XHTML / JS / CSS development, at this time.
Problem 1: I realize that it can edit those files, but its trying to manage my HTML docs as part of "my workspace", and all I want it to do is manage the files as part of my local www server HTdocs directory.
Problem 2: I would like to edit WYSIWYG-style, if possible. I tried installing a plug-in for that, but I wasn't able to get w4 toolkit to function properly. This would really help me to speed up development, I think.
Follow-up:
I've installed WTP and its dependencies (except for the tests portion, which had install problems due to dependencies that were seemingly irreconcilable).
You can link a folder in your workspace to somewhere on your filesystem. So in your case you could create a folder in your Eclipse project called "html" and link it to your Apache htdocs folder.
You should try Aptana Studio. It's available either as a stand-alone install (based on Eclipse) or as an Eclipse plugin. It has a good reputation for Web App dev.
Why not start with a web design software? Once you have the web pages laid out the way you want them, you can add them to your web application in eclipse. Eclipse is great for application development. Even though it can handle some page builder needs, it's probably not as good as a web design tool. In your case, you end up having to install plug-ins for page building.
Eclipse is software for coding, it's not designed for WYSIWYG editing. If you want WYSIWYG, you should use Dreamweaver or suchlike.
If you want to use Eclipse for what is good for, coding, the main alternatives are Web Tools Platform which is quite basic and could be already pre-installed depending on what version of Eclipse you got, and Aptana Studio. which is quite bloated.