- Notifications
You must be signed in to change notification settings - Fork0
DEPRECATED! -> The complete Jekyll source for the xPack web site
License
ilg-deprecated/xpack.github.io-source
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
This GitHub project, available fromxpack/xpack.github.io-source, contains the source files used to generate thexPack web site.
ThexPack web site is an organisationGitHub Pages site, stored in thexpack/xpack.github.io Git and publicly available fromhttp://xpack.github.io.
The web site is generated off-line byJekyll. It cannot be generated byGitHub Pages because it uses Jekyll plug-ins, considered unsafe and disabled by the GitHub Pages instance of Jekyll.
To be able to run the Jekyll build process, theruby interpreter and thegem tool are required. In OS X 10.10.5, these tools are pre-installed, at least when the Developer Command Line tools are present.
If you are like me and like really separated things, install a separate homebrew instance only for the jekyll builds.
$ mkdir -p"${HOME}/opt"$ git clone https://github.com/ilg-ul/opt-install-scripts \"${HOME}/opt/install-scripts.git"$ caffeinate bash $exec bash"${HOME}/opt/install-scripts.git/install-homebrew-jekyll.sh"
Add a new alias to your.profile:
alias ajkl='export PATH=/Users/ilg/opt/homebrew/jekyll/bin:${PATH}'
Then, in a new terminal:
$ ajkl$ which ruby/Users/ilg/opt/homebrew/jekyll/bin/ruby$ ruby --versionruby 2.4.2p198 (2017-09-14 revision 59899) [x86_64-darwin17]$ gem --version2.6.13$ bundler --versionBundler version 1.15.4
To manage the web site, a local copy of this repository is required.
$ git clone https://github.com/xpack/xpack.github.io-source.git xpack.github.io-source.git$ git clone https://github.com/xpack/xpack.github.io.git xpack.github.io.git
Install jekyll and all gems referred inGemfile. Probably usually there is no need to run bundler as root, it can ask for sudo if needed, but in my setup it looks necessary.
$cd xpack.github.io-source.git$ bundle installThe latest bundler is 1.16.0.pre.2, but you are currently running 1.15.4.To update, run`gem install bundler --pre`Fetching gem metadata from https://rubygems.org/.........Fetching version metadata from https://rubygems.org/..Fetching dependency metadata from https://rubygems.org/.Fetching i18n 0.8.0Installing i18n 0.8.0Fetching json 1.8.6Installing json 1.8.6 with native extensionsUsing minitest 5.10.1Fetching thread_safe 0.3.5Installing thread_safe 0.3.5Fetching addressable 2.4.0Installing addressable 2.4.0Using bundler 1.15.4Using colorator 1.1.0Fetching colorize 0.8.1Installing colorize 0.8.1Fetching ffi 1.9.17Installing ffi 1.9.17 with native extensionsUsing forwardable-extended 2.6.0Fetching gemoji 3.0.0Installing gemoji 3.0.0Fetching mini_portile2 2.1.0Installing mini_portile2 2.1.0Using mercenary 0.3.6Fetching parallel 1.12.0Installing parallel 1.12.0Fetching yell 2.0.7Installing yell 2.0.7Fetching sass 3.4.23Installing sass 3.4.23Fetching rb-fsevent 0.9.8Installing rb-fsevent 0.9.8Fetching kramdown 1.13.2Installing kramdown 1.13.2Fetching liquid 3.0.6Installing liquid 3.0.6Fetching rouge 1.11.1Installing rouge 1.11.1Using safe_yaml 1.0.4Fetching posix-spawn 0.3.13Installing posix-spawn 0.3.13 with native extensionsFetching jekyll-paginate 1.1.0Installing jekyll-paginate 1.1.0Fetching tzinfo 1.2.2Installing tzinfo 1.2.2Fetching jekyll-sitemap 0.11.0Installing jekyll-sitemap 0.11.0Fetching ethon 0.10.1Installing ethon 0.10.1Fetching rb-inotify 0.9.8Installing rb-inotify 0.9.8Using pathutil 0.14.0Fetching nokogiri 1.7.0.1Installing nokogiri 1.7.0.1 with native extensionsUsing jekyll-sass-converter 1.5.0Fetching activesupport 4.2.7.1Installing activesupport 4.2.7.1Fetching typhoeus 0.8.0Installing typhoeus 0.8.0Using listen 3.0.8Fetching html-pipeline 2.5.0Installing html-pipeline 2.5.0Fetching html-proofer 3.7.3Installing html-proofer 3.7.3Using jekyll-watch 1.5.0Fetching jekyll 3.2.1Installing jekyll 3.2.1Fetching jekyll-last-modified-at 1.0.0Installing jekyll-last-modified-at 1.0.0Fetching jekyll-mentions 1.1.3Installing jekyll-mentions 1.1.3Fetching jekyll-redirect-from 0.11.0Installing jekyll-redirect-from 0.11.0Fetching jemoji 0.8.0Installing jemoji 0.8.0Bundle complete! 9 Gemfile dependencies, 41 gems now installed.Use`bundle info [gemname]` to see where a bundled gem is installed.Post-install message from html-pipeline:$ bundleexec jekyll --versionjekyll 3.2.1
The current development cycle is edit-save-build-view.
The build can be performed automatically by Jekyll when started in server mode.
$cd xpack.github.io-source.git$ bundleexec jekyll serve --baseurl"" --destination _site_local --trace --port 4002
The build result is in_site_local.
To view the result, point the browser tolocalhost:4002.
$cd xpack.github.io-source.git$ bundleexec jekyll build --destination"../xpack.github.io.git"
The build result is in thexpack.github.io.git folder.
To publish, commit this Git and the new site will be automatically updated.
When new versions of Jekyll, or of gems, are available, runbundle update and be sure theGemfile.lock file is committed:
$cd xpack.github.io-source.git$ bundle updateThe latest bundler is 1.16.0.pre.2, but you are currently running 1.15.4.To update, run`gem install bundler --pre`Fetching gem metadata from https://rubygems.org/..........Fetching version metadata from https://rubygems.org/..Fetching dependency metadata from https://rubygems.org/.Resolving dependencies...Fetching i18n 0.8.6 (was 0.8.0)Installing i18n 0.8.6 (was 0.8.0)Fetching minitest 5.10.3 (was 5.10.1)Installing minitest 5.10.3 (was 5.10.1)Fetching thread_safe 0.3.6 (was 0.3.5)Installing thread_safe 0.3.6 (was 0.3.5)Using addressable 2.4.0Using bundler 1.15.4Using colorator 1.1.0Using colorize 0.8.1Using ffi 1.9.18 (was 1.9.17)Using forwardable-extended 2.6.0Using gemoji 3.0.0Fetching mini_portile2 2.3.0 (was 2.1.0)Installing mini_portile2 2.3.0 (was 2.1.0)Using mercenary 0.3.6Using parallel 1.12.0Using yell 2.0.7Using rb-fsevent 0.10.2 (was 0.9.8)Using kramdown 1.15.0 (was 1.13.2)Using liquid 3.0.6Using rouge 1.11.1Using safe_yaml 1.0.4Using posix-spawn 0.3.13Using jekyll-paginate 1.1.0Fetching tzinfo 1.2.3 (was 1.2.2)Installing tzinfo 1.2.3 (was 1.2.2)Using jekyll-sitemap 0.11.0Using ethon 0.10.1Using rb-inotify 0.9.10 (was 0.9.8)Using pathutil 0.14.0Fetching nokogiri 1.8.1 (was 1.7.0.1)Installing nokogiri 1.8.1 (was 1.7.0.1) with native extensionsFetching activesupport 4.2.10 (was 4.2.7.1)Installing activesupport 4.2.10 (was 4.2.7.1)Using typhoeus 0.8.0Using sass-listen 4.0.0Using listen 3.0.8Fetching html-pipeline 2.7.1 (was 2.5.0)Installing html-pipeline 2.7.1 (was 2.5.0)Using html-proofer 3.7.3Using sass 3.5.1 (was 3.4.23)Using jekyll-watch 1.5.0Using jekyll-sass-converter 1.5.0Using jekyll 3.2.1Using jekyll-last-modified-at 1.0.0Using jekyll-mentions 1.1.3Using jekyll-redirect-from 0.11.0Fetching jemoji 0.8.1 (was 0.8.0)Installing jemoji 0.8.1 (was 0.8.0)Bundle updated!
People using forked repositories must runbundle install to be sure the required versions are properly installed.
All blog posts are in the_posts folder.
All web pages are in thepages folder.
To maintain sitelink.xml usefulness, while maintaining pages and posts, it is necessary to keep this variable up-to-date. When the pages are generated off-line, this field is automatically updated by a plug-in.
As per_config.yml, the default timezone is UTC. For other timezones, set it explicitly as offset (for example +0300)
The embedded images are located in the/assets/images folder.
For a certain degree of portability, the recommended editable format is PPTX. On macOS, PPTX files can be processed with Keynote, although saving can be done only indirectly viaExport To, not directly viaSave.
The preferred format is PNG. The available width is lower than 700 px, but apparently Jekyll scales images properly. By default Keynote exports images as 1024 x 768, which is generally ok for regular (non-HiRes) screens.
About
DEPRECATED! -> The complete Jekyll source for the xPack web site
Resources
License
Code of conduct
Uh oh!
There was an error while loading.Please reload this page.