onsen.io

This repository contains the assets in Onsen UI Website, available on http://onsen.io. Please Visit Onsen UI if you need access to the framework itself.

Installation

git clone --recurse-submodules git@github.com:OnsenUI/onsen.io.git
cd onsen.io
npm install -g gulp
npm install

# Update necessary submodules
git submodule update --remote dist/v2/OnsenUI dist/playground

# Build Onsen UI
(cd dist/v2/OnsenUI && npm install && npm run build && npm run docs)

How to Build

gulp generate --lang en
gulp generate --lang ja

Edit & Serve

gulp serve --lang en

Translate

1. $ gulp i18n-extract # This will generate POT files into src/i18n/gettext
2. And use PO editor to generate po files
3. $ gulp i18n-translate # This will translate and overwrite files into src/documents_ja/

Local development

To use your local version of the Onsen UI main repository, symlink it:

rm -rf dist/v2/OnsenUI/ && ln -s ~/src/OnsenUI/ dist/v2

Releasing to Production

This repository is set up on CircleCI to automatically build with every commit. Commits to master are automatically deployed to the staging website at s.onsen.io. To deploy to production, merge master into the production branch. Typically this merge is done through a pull request on GitHub, even if you immediately merge it yourself. Once merged, CircleCI will automatically deploy everything in the production branch.

How to contribute

We will happily accept contributions to the onsen.io website. However, it is much more likely that it is another repository that you want to make your pull request to. This repository contains the Onsen UI marketing materials, and brings in most of the rest of the content from other repositories.

Which repository to choose?

Here is where you should make changes:

• Onsen UI Framework: https://github.com/OnsenUI/OnsenUI
• Documentation
  • API Definitions: https://github.com/OnsenUI/OnsenUI (see its documentation guide for how this works)
  • Tutorials: https://github.com/OnsenUI/playground (taken from the examples in the Playground)
  • Guides: This repository
  • Design: This repository
• Theme Roller: https://github.com/OnsenUI/theme-roller
• Playground: https://github.com/OnsenUI/playground
• News Dropdown: https://github.com/OnsenUI/recent-activities
• Homepage Kitchensink Example: https://github.com/OnsenUI/vue-onsenui-kitchensink
• Onsen.io Landing Pages: This repository

Contributing to this repository

If the repository you need to make changes to is this one, then the workflow is simple, and the same as you will see in other open source projects.

1. Fork the repository
2. Commit your changes. Please squash commits where possible.
3. Make a pull request to master.
4. After you've made a pull request we will review it. If everything is fine and we like the change the contribution will be pulled into the repository. In the case where there are some issues with the code or we disagree with how it's been implemented we will describe the issues in the comments so they can be corrected.