/nuxtjs.org

Nuxt.js Documentation Website (Universal Vue.js Application built with Nuxt.js)

Primary LanguageVue

nuxtjs.org

Gitpod Ready-to-Code

Universal Vue.js Application built with Nuxt.js.

Setup

git clone https://github.com/nuxt/nuxtjs.org.git
cd nuxtjs.org/
yarn

Content and Translations

The markdown files are stored in the content folder.

  • The new docs are in the folder called guides.
  • The i18n folder contains the locale file for each language
  • The navigation is created from the markdown files using the menu if it exits and if not the title which are found in the yaml of each file (You can add a menu key if you need one if there isn't one already there).

When working on a new language you will need to:

  • Create a new branch
  • Create the 18n locale file in the i18n folder by copying the en version and modifying it to the new language.
  • Add your language to the nuxt.config file in the i18n property by copying the en version and modifying it to the new language
  • In the content directory create a folder for your language using your countries locale and then copy the en/guides folder into it.
  • You can then start translating your files.
  • Once finished push your changes and then create a pull request.

Development

Start the dev server on http://localhost:3000

yarn dev

To change the locale, create a .env file with the locale you want to use. An example .env file has been provided which you can copy it's contents to your .env file and change the language to the one you want to see the site in.

NUXT_LOCALE=fr

or add the local in the command line.

# start the documentation in french
NUXT_LOCALE=fr yarn dev

As we are using the content module you can double click on the page in the browser and modify your text directly there which will save your changes just like when you edit in your browser.

Production

If working with a language other than English you will not be able to see the language when running the generate command as for production builds we will only show the English version of the new guides until the guides are almost fully translated. You can still see your translated pages when using the dev command.

yarn generate
yarn start
# Checkout http://localhost:3000

zh.nuxtjs.org

Nuxt.js 官网 nuxtjs.org 的简体中文版,由凹凸实验室负责翻译整理。

欢迎关注我们的微信公众号(微信里面搜凹凸实验室),关于 Nuxt.js 的最新信息会通过公众号发布。

Chinese translation of primary Nuxt.js documentation site. Supported by AOTU Labs.