preCICE Webpage - precice.org
The website is using Jekyll static website generator and Github pages.
To run and develop it locally you would need Ruby and Bundler.
With Ruby, you can install bundler using gem install bundler
.
Then install pre-commit
to keep your commits clean.
After that all you need is:
git clone https://github.com/precice/precice.github.io && cd precice.github.io
pre-commit install
bundle install
git submodule init
git submodule update
bundle exec jekyll serve -l
You can now view website locally in your browser at localhost:4000
.
Submodules do not yet get updated automatically. This means if you change something in the OpenFOAM adapter documentation or the description of the tutorials, you need to explicitly trigger an update here:
git submodule update --remote --merge
This updates all submodules. You can call it from everywhere (you do not need to cd
into the submodule).
Afterwards, commit and push.
Do not directly edit the content of the submodules from within the website repository. This might give ugly merge conflicts.
If you would like to learn more about the preCICE documentation, a good start are the documentation of the documentation pages.
Edit _includes/news_banner.html
.
A good starting point is the following:
<div class="background-light banner-container">
<div class="container">
<div class="row no-margin">
<div class="col-lg-12 banner">
<p class="no-margin">
This is the text of my news banner.
</p>
</div>
</div>
</div>
</div>
Use the following to selectively change appearance.
{% if include.landing %}
Displayed on the landing page.
{% else %}
Displayed on other pages.
{% endif %}
-
If you get permission issues to install gems, resist the impulse of
sudo
: you can install the dependencies locally by runningbundle config set --local path 'vendor/bundle'
beforebundle install
. -
If you get errors like
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
ormkmf.rb can't find header files for ruby at /usr/lib/ruby/include/ruby.h
, then (as the error message suggests), you may need to install a Ruby development environment (e.g.,ruby-dev
). -
If you are a poor soul that is stuck developing on Windows, the
-l
flag is known to crash, so best try without. -
Should you get the warning
Fetching citation data failed with OpenURI::HTTPError
while building the site locally, then you have been rate limited by Google Scholar. The citation database won't be up to date. Alternatively open http://scholar.google.com/ in a browser and complete the Captcha.
For further information see the documentation page on common issues.
The content of the preCICE webpage is licensed under CC-BY 4.0. Third-party licenses (e.g. of the framework we use) are collected in the licenses
subfolder. Note that preCICE itself has a software license, LGPL v3.