{"id":22377237,"url":"https://github.com/micro-os-plus/web-jekyll","last_synced_at":"2025-07-30T23:32:00.044Z","repository":{"id":136223497,"uuid":"53078521","full_name":"micro-os-plus/web-jekyll","owner":"micro-os-plus","description":"The complete Jekyll source for the µOS++ IIIe web site","archived":false,"fork":false,"pushed_at":"2023-10-15T06:58:47.000Z","size":10694,"stargazers_count":2,"open_issues_count":6,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-10-16T08:50:42.021Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://micro-os-plus.github.io","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/micro-os-plus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-03-03T19:50:46.000Z","updated_at":"2023-02-27T22:50:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"1a3b62f6-e4da-4834-a410-a59807e32cfb","html_url":"https://github.com/micro-os-plus/web-jekyll","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fweb-jekyll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fweb-jekyll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fweb-jekyll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fweb-jekyll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/micro-os-plus","download_url":"https://codeload.github.com/micro-os-plus/web-jekyll/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228198880,"owners_count":17883776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-04T22:13:19.268Z","updated_at":"2024-12-04T22:13:19.877Z","avatar_url":"https://github.com/micro-os-plus.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/micro-os-plus/micro-os-plus.github.io-source.svg?branch=master)](https://travis-ci.org/micro-os-plus/micro-os-plus.github.io-source)\n\n# The µOS++ web site source\n\n## Overview\n\nThis GitHub project, available from [micro-os-plus/micro-os-plus.github.io-source](https://github.com/micro-os-plus/micro-os-plus.github.io-source), contains the source files used to generate the **[µOS++ web site](http://micro-os-plus.github.io)**.\n\n## Destination URL\n\nThe **µOS++ web site** is an organisation [GitHub Pages](https://pages.github.com) site, stored in the [micro-os-plus/micro-os-plus.github.io](https://github.com/micro-os-plus/micro-os-plus.github.io) Git and publicly available from [http://micro-os-plus.github.io](http://micro-os-plus.github.io).\n\n## Jekyll\n\nThe web site is generated off-line by [Jekyll](http://jekyllrb.com). It cannot be generated by [GitHub Pages](https://pages.github.com) because it uses Jekyll plug-ins, considered unsafe and disabled by the GitHub Pages instance of Jekyll.\n\n## Prerequisites\n\nTo be able to run the Jekyll build process, the `ruby` interpreter and the `gem` tool are required. In OS X 10.10.5, these tools are preinstalled, at least when the Developer Command Line tools are present.\n\n### Install separate homebrew\n\nIf you are like me and like really separated things, install a separate homebrew instance only for the jekyll builds.\n\n```\n$ HB_PREFIX=\"/opt/homebrew-jekyll3\"\n\n$ echo 'Enter sudo password'\n$ sudo rm -rf \"${HB_PREFIX}\"\n$ sudo mkdir -p \"${HB_PREFIX}\"\n$ sudo bash -c \"(curl -L https://github.com/Homebrew/homebrew/tarball/master | tar -x -v --strip 1 -C \"${HB_PREFIX}\" -f -)\"\n\n$ \"${HB_PREFIX}/bin/brew\" --version\n$ \"${HB_PREFIX}/bin/brew\" update\n\n$ alias hbj3='export PATH=/opt/homebrew-jekyll3/bin:$PATH'\n\n$ hbj3\n\n$ sudo brew install ruby\n```\n\nThe result is in `/opt/homebrew-jekyll3/Cellar/ruby/2.3.1`\n\n### Install bundler\n\n```\n$ ruby --version\nruby 2.3.1p112 (2016-04-26 revision 54768) [x86_64-darwin15]\n$ gem --version\n2.5.1\n$ sudo gem install bundler\nFetching: bundler-1.12.5.gem (100%)\nSuccessfully installed bundler-1.12.5\nParsing documentation for bundler-1.12.5\nInstalling ri documentation for bundler-1.12.5\nDone installing documentation for bundler after 7 seconds\n1 gem installed\n$ bundler --version\nBundler version 1.12.5\n```\n\n## Clone Git\n\nTo manage the web site, a local copy of this repository is required.\n\n```sh\ngit clone https://github.com/micro-os-plus/micro-os-plus.github.io-source.git micro-os-plus.github.io-source.git\ngit clone https://github.com/micro-os-plus/micro-os-plus.github.io.git micro-os-plus.github.io.git\n```\n\n## Install jekyll \u0026 gems\n\nInstall jekyll and all gems referred in `Gemfile`. 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.\n\n```console\n$ cd micro-os-plus.github.io-source.git\n$ sudo bundle install\nFetching gem metadata from https://rubygems.org/\nFetching version metadata from https://rubygems.org/\nFetching dependency metadata from https://rubygems.org/\nResolving dependencies...\nUsing i18n 0.7.0\nUsing json 1.8.3\nInstalling minitest 5.9.0\nUsing thread_safe 0.3.5\nInstalling addressable 2.4.0\nInstalling colorator 1.1.0\nInstalling ffi 1.9.14 with native extensions\nInstalling forwardable-extended 2.6.0\nUsing gemoji 2.1.0\nUsing mini_portile2 2.1.0\nUsing pkg-config 1.1.7\nUsing sass 3.4.22\nUsing rb-fsevent 0.9.7\nUsing kramdown 1.11.1\nUsing liquid 3.0.6\nUsing mercenary 0.3.6\nUsing rouge 1.11.1\nUsing safe_yaml 1.0.4\nUsing jekyll-paginate 1.1.0\nUsing bundler 1.12.5\nUsing tzinfo 1.2.2\nInstalling jekyll-sitemap 0.11.0\nUsing rb-inotify 0.9.7\nInstalling pathutil 0.14.0\nUsing nokogiri 1.6.8\nUsing jekyll-sass-converter 1.4.0\nInstalling activesupport 4.2.7.1\nUsing listen 3.0.8\nInstalling html-pipeline 2.4.2\nInstalling jekyll-watch 1.5.0\nInstalling jekyll 3.2.1\nUsing jekyll-last-modified-at 0.3.4\nInstalling jekyll-mentions 1.1.3\nInstalling jekyll-redirect-from 0.11.0\nInstalling jemoji 0.7.0\nBundle complete! 7 Gemfile dependencies, 35 gems now installed.\nUse `bundle show [gemname]` to see where a bundled gem is installed.\n$ bundle exec jekyll --version\njekyll 3.2.1\n```\n\n## Development\n\nThe current development cycle is edit-save-build-view.\n\nThe build can be performed automatically by Jekyll when started in server mode.\n\n```sh\ncd micro-os-plus.github.io-source.git\nbundle exec jekyll serve --baseurl \"\" --destination _site_local --trace --port 4001\n```\n\nThe build result is in `_site_local`.\n\nTo view the result, point the browser to `localhost:4001`.\n\n## Publish\n\n```sh\ncd micro-os-plus.github.io-source.git\nbundle exec jekyll build --destination ../micro-os-plus.github.io.git\n```\n\nThe build result is in the `micro-os-plus.github.io.git` folder.\n\nTo publish, commit this Git and the new site will be automatically updated.\n\n## Updates\n\nWhen new versions of Jekyll, or of gems, are available, run `bundle update` and be sure the `Gemfile.lock` file is committed:\n\n```console\n$ cd micro-os-plus.github.io-source.git\n$ sudo bundle update\nFetching gem metadata from https://rubygems.org/\nFetching version metadata from https://rubygems.org/\nFetching dependency metadata from https://rubygems.org/\nResolving dependencies...\nUsing i18n 0.7.0\nUsing json 1.8.3\nUsing minitest 5.9.0\nUsing thread_safe 0.3.5\nUsing addressable 2.4.0\nUsing colorator 1.1.0\nUsing ffi 1.9.14\nUsing forwardable-extended 2.6.0\nUsing gemoji 2.1.0\nUsing mini_portile2 2.1.0\nUsing pkg-config 1.1.7\nUsing sass 3.4.22\nUsing rb-fsevent 0.9.7\nUsing kramdown 1.11.1\nUsing liquid 3.0.6\nUsing mercenary 0.3.6\nUsing rouge 1.11.1\nUsing safe_yaml 1.0.4\nUsing jekyll-paginate 1.1.0\nUsing bundler 1.12.5\nUsing tzinfo 1.2.2\nUsing jekyll-sitemap 0.11.0\nUsing rb-inotify 0.9.7\nUsing pathutil 0.14.0\nUsing nokogiri 1.6.8\nUsing jekyll-sass-converter 1.4.0\nUsing activesupport 4.2.7.1\nUsing listen 3.0.8\nUsing html-pipeline 2.4.2\nUsing jekyll-watch 1.5.0\nUsing jekyll 3.2.1\nUsing jekyll-last-modified-at 0.3.4\nUsing jekyll-mentions 1.1.3\nUsing jekyll-redirect-from 0.11.0\nUsing jemoji 0.7.0\nBundle updated!\n```\n\nPeople using forked repositories must run `bundle install` to be sure the required versions are properly installed.\n\n## Folder structure\n\n### Posts\n\nAll blog posts are in the `_posts` folder.\n\n### Pages\n\nAll web pages are in the `pages` folder.\n\n## 'last\\_modified\\_at:'\n\nTo 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.\n\n## Timezone\n\nAs per `_config.yml`, the default timezone is UTC. For other timezones, set it explicitly as offset (for example +0300)\n\n## Images\n\nThe embedded images are located in the `/assets/images` folder.\n\nFor 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 via **Export To**, not directly via **Save**.\n\nThe 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro-os-plus%2Fweb-jekyll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicro-os-plus%2Fweb-jekyll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro-os-plus%2Fweb-jekyll/lists"}