Giter VIP home page Giter VIP logo

micro-ros.github.io's Introduction

micro-ROS web site

pipeline status

This is the source for the micro-ROS website, available at https://micro-ros.github.io/

Editing

See editing instructions

License

The content of this repository and the generated website is open-sourced under the Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0) license. You are free to:

  • Share — copy and redistribute the material in any medium or format for any purpose, even commercially. The licensor cannot revoke these freedoms as long as you follow the license terms.

Under the following terms:

  • Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
  • NoDerivatives — If you remix, transform, or build upon the material, you may not distribute the modified material.
  • No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.

See the LICENSE file for details.

Please note the following third-party elements and content:

  • The website is based on the MIT-licensed template Jekyll Doc Theme by Can Güney Aksakalli and contributors. The template files and source code can be identified by the commits by his user name aksakalli and by the user names of the contributors in the git history. Starting point for the development of this website was the version as of 23 September 2018, cf. commit 3cc3f49.

  • All logos and product names are property of their respective owners. All company names, logos and product names used in this website are for identification purposes only. Their use does not imply endorsement.

For details on the open source components included in the micro-ros.github.io repository, see the file 3rd-party-licenses.txt.

Running locally

To test locally, you need a local version of Jekyll, the site-generation engine used by GitHub Pages. See Jekyll Quickstart for installation instructions.

After installing Jekyll, install all dependencies by running

bundle install

Then, you may launch Jekyll to build and serve the website continuously by

bundle exec jekyll serve

For the includes of README.md files on the micro-ROS demos (in the tutorials chapter) from the corresponding repositories, please init and update the corresponding git submodules (i.e. git submodule init ; git submodule update).

Testing generated site

To test the generated HTML site, you can use html-proofer gem. This Ruby gem checks and validates the jekyll generated HTML files. It checks a broad set of points: internal and external links existence (alerting of possible 404 errors), HTML attributes of the images and so on.

To install it, It has been incorporated in the Gemfile so the previous dependency install command would have already installed it.

You can run bundle exec jekyll build followed by bundle exec htmlproofer ./_site to build and test the generated site. However, note that a comprehensive configuration is required for the htmlproofer. Therefore, we strongly suggest to run the utility script at

./scripts/cibuild

which is also used for CI.

micro-ros.github.io's People

Contributors

ralph-lange avatar pablogs9 avatar janstaschulat avatar iluetkeb avatar borjaouterelo avatar imuguruza avatar franfin avatar aksakalli avatar norro avatar mamerlan avatar github-actions[bot] avatar dependabot[bot] avatar acuadros95 avatar rpcme avatar coliff avatar amx-piap avatar christophebedard avatar tkolcon avatar vmayoral avatar jamoralp avatar gavanderhoorn avatar avibrown avatar julionce avatar mwleeds avatar robertwilbrandt avatar kohei306 avatar lein1013 avatar jayhou avatar svaichu avatar thecranston avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.