Skip to content

waqasiqbal123/precice.github.io

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

preCICE Webpage - precice.org

Local development

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.

After that all you need is:

git clone https://github.com/precice/precice.github.io && cd precice.github.io
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.

Update submodules

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.

Further information

If you would like to learn more about the preCICE documentation, a good start are the documentation of the documentation pages.

Common issues while building the site

  • If you get permission issues to install gems, resist the impulse of sudo: you can install the dependencies locally by running bundle config set --local path 'vendor/bundle' before bundle install.

  • If you get errors like Gem::Ext::BuildError: ERROR: Failed to build gem native extension. or mkmf.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.

About

The website of preCICE

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 47.1%
  • CSS 31.0%
  • TeX 8.7%
  • JavaScript 7.8%
  • Ruby 4.2%
  • Shell 1.2%