Am Sonntag, den 19.04.2020, 18:28 +0200 schrieb [email protected]: > Trying Jekyll for the first time, I get hit by the same issue. > > Indeed this flag is a good start, but afterwards: > > 1. we have to gather we should change the Gemfile to use: > > source "file:///usr/lib/ruby/vendor_ruby"
Why? You have three choices: 1) Use the Debian package management and don't use bunlder at all (jekyll new --skip-bundle). All the Jekyll plugins have been packaged and most of them can be found in stable-backports. If you are missing some please let me know. Just add the plugins you need to Gemfile and _config.yml, run jekyll, and that should be it. In case of a missing theme (I just packaged the minima theme) one can use the ruby-jekyll-remote-theme package (and the plugin inside) to avoid bundler. 2) Use the package management and bundler at least partly. In this case set GEM_HOME and GEM_PATH accordingly in your user account to install gems into your user account (`bundle env`) and not /var or vendor/bundle. I don't recommend this at all if you don't know what you are doing, because things can become quite difficult and painful. 3) Use bundler completely (set GEM_HOME, GEM_PATH) and use `bundle <command> -- path vendor/bundle`. In this case you don't need any Debian package except for ruby itself. In option 2 and 3 you are on your own and should get support from a ruby community. You will also need the build-essential and ruby-dev packages as well as other -dev packages depending on the Ruby extension bundler tries to build. [..] > Being quite a stranger to ruby things (which is usually a good starting point > for validating a user documentation ;), > all this is extremely confusing :) I understand. Please stick to the Debian packages then and remove all gems from your system (usually vendor/bundle, ~/.bundle, Gemfile.lock, ~/.gems, etc.). We are responsible for the Debian package management and I run jekyll perfectly without using bundler at all: https://salsa.debian.org/ruby-team/ruby-team.pages.debian.net https://salsa.debian.org/debichem-team/debichem-team.pages.debian.net If you are a stable user please let me know which of the plugins you need are missing in backports. My goal is to provide a full jekyll environment for current stable users (upcoming stable will have full support). https://packages.debian.org/search?keywords=jekyll > For a start, you could include a step-by-step instruction sheet to make use > of jekyll in Debian. That's a good idea. I'll add a README file to jekyll and update the jekyll backport as soon as jekyll-theme-minima hits testing. For now: jekyll new --skip-bundler Adjust Gemfile and _config.yml to contain the plugins you need (see the two project links above). Install the plugins you need (see the packages page above). Add your content and run `jekyll s` or `jekyll b`. See `man jekyll` for more information (jekyll 3.8.6 is in backports too). Regards, Daniel
signature.asc
Description: This is a digitally signed message part
_______________________________________________ Pkg-ruby-extras-maintainers mailing list [email protected] https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/pkg-ruby-extras-maintainers
