Applies to publican_creators 1.2.2

2 Introduction

Before you can start you must check if you have installed Ruby. To do this you can type in a console: ruby --version. The output can be similar to that one:

ruby 2.2.1p85 (2015-02-26 revision 49769) [x86_64-linux]

.

If there are no ruby inside the output you have to follow the next section. Otherwise you can skip that step and go to Section 2.2, “Installing publican_creators”.

2.1 Installing Ruby

One of the easiest ways to install Ruby is by using RVM. So follow the next steps:

  1. Type in your console: gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

  2. Type now: curl -sSL https://get.rvm.io | bash -s stable

    The output should like similar to that one:

    sascha@sascha-desktop:~$ curl -sSL https://get.rvm.io | bash -s stable
    Downloading https://github.com/rvm/rvm/archive/1.26.11.tar.gz
    Downloading https://github.com/rvm/rvm/releases/download/1.26.11/1.26.11.tar.gz.asc
    gpg: Signatur vom Mo 30 Mär 2015 23:52:13 CEST mittels RSA-Schlüssel ID BF04FF17
    gpg: Korrekte Signatur von "Michal Papis (RVM signing)" [unbekannt]
    gpg: WARNUNG: Dieser Schlüssel trägt keine vertrauenswürdige Signatur!
    gpg: Es gibt keinen Hinweis, daß die Signatur wirklich dem vorgeblichen Besitzer gehört.
    Haupt-Fingerabdruck = 409B 6B17 96C2 7546 2A17 0311 3804 BB82 D39D C0E3
    Unter-Fingerabdruck = 62C9 E5F4 DA30 0D94 AC36 166B E206 C29F BF04 FF17
    GPG verified '/home/sascha/.rvm/archives/rvm-1.26.11.tgz'
    Installing RVM to /home/sascha/.rvm/
    Adding rvm PATH line to /home/sascha/.profile /home/sascha/.mkshrc /home/sascha/.bashrc
    /home/sascha/.zshrc.
    Adding rvm loading line to /home/sascha/.profile /home/sascha/.bash_profile /home/sascha/.zlogin.
    Installation of RVM in /home/sascha/.rvm/ is almost complete:
    * To start using RVM you need to run `source /home/sascha/.rvm/scripts/rvm`
    in all your open shell windows, in rare cases you need to reopen all shell windows.
    # saigkill,
    #
    # Thank you for using RVM!
    # We sincerely hope that RVM helps to make your life easier and more enjoyable!!!
    #
    # ~Wayne, Michal & team.
    In case of problems: http://rvm.io/help and https://twitter.com/rvm_io

    Note
    Note

    If this command fails, you have to install the curl package. Use your package manager to do this.

  3. To use RVM you have two options. First, you can log out yourself and log in again. The other option is just to type: source /home/sascha/.rvm/scripts/rvm. Instead of “sascha” you have to place your user name.

  4. Now type: rvm install 2.4.1. If any later stable Ruby version, then you can replace the 2.4.1 with the newer version.

  5. The output shows similar that:

    sascha@sascha-desktop:~$ rvm install 2.4.1
    Searching for binary rubies, this might take some time.
    No binary rubies available for: ubuntu/15.04/x86_64/ruby-2.4.1.
    Continuing with compilation. Please read 'rvm help mount' to get more information on binary rubies.
    Checking requirements for ubuntu.
    Requirements installation successful.
    Installing Ruby from source to: /home/sascha/.rvm/rubies/ruby-2.4.1, this may take a while depending on
    your cpu(s)...
    ruby-2.4.1 - #downloading ruby-2.4.1, this may take a while depending on your connection...
    % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed
    100 12.7M 100 12.7M 0 0 2234k 0 0:00:05 0:00:05 --:--:-- 3018k
    ruby-2.4.1 - #extracting ruby-2.4.1 to /home/sascha/.rvm/src/ruby-2.4.1....
    ruby-2.4.1 - #applying patch /home/sascha/.rvm/patches/ruby/2.4.1/fix_installing_bundled_gems.patch.
    ruby-2.4.1 - #configuring.........................................................
    ruby-2.4.1 - #post-configuration..
    ruby-2.4.1 - #compiling...............................................................................
    ruby-2.4.1 - #installing..................
    ruby-2.4.1 - #making binaries executable..
    ruby-2.4.1 - #downloading rubygems-2.4.6
    % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed
    100 437k 100 437k 0 0 601k 0 --:--:-- --:--:-- --:--:-- 602k
    No checksum for downloaded archive, recording checksum in user configuration.
    ruby-2.4.1 - #extracting rubygems-2.4.6....
    ruby-2.4.1 - #removing old rubygems.........
    ruby-2.4.1 - #installing rubygems-2.4.6.....................
    ruby-2.4.1 - #gemset created /home/sascha/.rvm/gems/ruby-2.4.1@global
    ruby-2.4.1 - #importing gemset
    /home/sascha/.rvm/gemsets/global.gems...............................................
    ruby-2.4.1 - #generating global wrappers........
    ruby-2.4.1 - #gemset created /home/sascha/.rvm/gems/ruby-2.4.1
    ruby-2.4.1 - #importing gemsetfile /home/sascha/.rvm/gemsets/default.gems evaluated to empty gem list
    ruby-2.4.1 - #generating default wrappers........
    ruby-2.4.1 - #adjusting #shebangs for (gem irb erb ri rdoc testrb rake).
    Install of ruby-2.4.1 - #complete

    A ruby --version should output your version:

    ruby 2.2.1p85 (2015-02-26 revision 49769) [x86_64-linux]

You installed now Ruby (hopefully) without troubles. For further information about RVM you can visit this link.

2.2 Installing publican_creators

For installing publican_creators you now have to type in the console: gem install publican_creators. This command solves the soft-dependencies of the program. The output looks similar that one:

sascha@sascha-desktop:~$ ruby --version
ruby 2.2.1p85 (2015-02-26 revision 49769) [x86_64-linux]
sascha@sascha-desktop:~$ gem install PublicanCreators
Fetching: parseconfig-1.0.6.gem (100%)
Successfully installed parseconfig-1.0.6
Fetching: mini_portile-0.6.2.gem (100%)
Successfully installed mini_portile-0.6.2
Fetching: nokogiri-1.6.6.2.gem (100%)
Building native extensions. This could take a while...
Successfully installed nokogiri-1.6.6.2
Fetching: dir-0.1.2.gem (100%)
Successfully installed dir-0.1.2
Fetching: PublicanCreators-0.2.0.0.gem (100%)
Successfully installed PublicanCreators-0.2.0.0
Parsing documentation for parseconfig-1.0.6
Installing ri documentation for parseconfig-1.0.6
Parsing documentation for mini_portile-0.6.2
Installing ri documentation for mini_portile-0.6.2
Parsing documentation for nokogiri-1.6.6.2
Installing ri documentation for nokogiri-1.6.6.2
Parsing documentation for dir-0.1.2
Installing ri documentation for dir-0.1.2
Parsing documentation for publican_creators-1.2.2
Installing ri documentation for publican_creators-1.2.2
Done installing documentation for parseconfig, mini_portile, nokogiri, dir, PublicanCreators after 5 seconds
5 gems installed

The installation can take some time, because some of the dependencies must compiled natively on your computer.

2.2.1 Running the setup

For running the setup go to the gem's directory with cd .rvm/gems/ruby-2.4.1/gems/publican_creators-1.2.2. Then just type rake setup.

Important
Important

Keep in mind, that the 2.4.1 from ruby-2.4.1 must match your chosen version.

The whole setup process looks like that output:

rake setup
Installed icons
Creating Desktop file for publican_creators
Creating Desktop file for Revision updater
Setup finished

Print this page