nuxt / website-v2 Goto Github PK

View Code? Open in Web Editor NEW

2.2K 49.0 1.2K 91.11 MB

Nuxt 2 Documentation Website

Home Page: https://v2.nuxt.com

License: Other

CSS 0.15% Vue 58.41% JavaScript 39.42% TypeScript 2.02%

nuxt

website-v2's Introduction

Website and documentation of Nuxt 2

We are using Docus to write our documentation (we plan to open source it in the following weeks once the documentation is ready).

Setup

git clone https://github.com/nuxt/website-v2.git
cd website-v2
npm install

We also recommend to install the Docus extension for VS Code.

Development

Start the development server on http://localhost:4000

yarn dev

The pages are generated from content/, you can start editing them to start helping us on documenting Nuxt 💚

License

Design materials for website by Nuxt project is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License.
Based on a work at nuxt/website-v2.

website-v2's People

Contributors

Stargazers

Watchers

Forkers

limichange translation-gang phirov o2team macku99 alerdenisov zdzdesigner mattpardee rubythonode ememumoh melonq milestonebooks alexmoreno tinyug darno786 xiao8cn rafamaciel treasureling tinyrepository renjie1996 mariogodinez jermeyyann hu949277923 codefingas safilo silas-ss ashoktandan pawelmadeja leetia316 zbm2001 beauty85 jlachancekffein ezc tdhulster prakashpie kgriffs yu3ver yuwq1098 iamonuwa netzon-daniel whjvenyl mufidtk dawnsgithub songyandong zhukovsp dzwillia sinchang-codespaces heruiwoniou firecodes kdncode lolxy ihalton cwonrails hoangpq jian652485051 ymwv baruide patrickdaze sfilata mrrossbennett tapitapeh bymoya mattbrailsford natocto liuxiucai lxcuso4 jerry-goodboy ttjn18 scramantha cmty-bot-dev tedw yangjiayang222 baermowei yamanashi12 luxixiang angulartist inouetakuya delktsai desty luwenchun felixgrey zengyq529 senyong sushujuan lonelytomb hzj680539 organizationhzj makenowjust valorloff silry junilhwang yangbo568969859 petermenocal 001chinaneil nan92 mjzhang1993 narci2010 zjians wangfeiixang liyuanwen1993

website-v2's Issues

License for the web site

I like this site's layout and integrations. but i can't find a license or limitation for public using.

Can I use this source for my open-source project web site?

Navbar problems on iPad

Open docs site on iPad. Navbar looks very bad

how to add babel-polyfill to webpack entry nuxt

why i have to add babel-polyfill,my pc application only work in chrome and firefox,other like qq browser cannot load.i found that js file have a error,and some es6 still exist, my config is
build: {
babel: {
presets: ['es2015', 'stage-2'],
'plugins': ['transform-runtime']
},
extractCSS: true,
vendor: [
'babel-polyfill',
'eventsource-polyfill',
'swiper',
'axios'
]}

but after build i found nothing have change, tell my the right way,my application will online soon,i need your help really, thx

https://zh.nuxtjs.org error 404

UI BUG

Nuxt Searching Woes

I enjoy working in the Nuxt framework and have transitioned to using it for client work with my team. In general, it's fantastic, with only a few obvious pain points (SSR with vendor libraries is a notable one).

However, I do want to complain about the choice of name. I get it; it's a play on NextJS from React, and it's humorous. However, trying to find Nuxt documentation or community examples is a nightmare because Next dominates the SEO. Virtually any time I try to find something for Nuxt, Google attempts to autocorrect to Next, and I end up writing +nuxt -next <my actual query any time I want to find something relevant.

Is there anything we can do to help with this in general? If not, would a name change be completely out of the realm of possibility? I don't imagine we're the only group out there facing this on a regular basis.

performance.prefetch does not disable the feature

performance: {
  prefetch: false
}

It does not have any effect, and it still have so many <link rel="prefetch" /> in <head> if I add page into the router.

Getting a 500 error when I click on any link from the main page.

When I click on any link on the main nuxtjs.org page, I get a 500 error "Cannot read property 'status' of undefined".

can not get `app.$axios.defaults.headers.cookie` on linux

os：Ubuntu 16.04.2

node.js：8.0.0.0

code：

result：

code is normal on mac

ko.nuxtjs.org is not appeared.

Spelling mistake on docs

https://nuxtjs.org/guide/views

"To extend the html template, create a app.html at the root of your project."

a app.html should be an app.html

nuxt generate` with v-on:click

I was generating a simple project from nuxjs website. It works fine but when i added a button with v-on:click event.,in the generated one, the button doesn't work. It works with npm run dev.
Please help me out. Thanks
Below is my index.vue

<template>
  <section class="container">
    <div>
      <logo/>
      <h1 class="title">
        NUXT
      </h1>
      <h2 class="subtitle">
        Universal Vue.js Application
      </h2>
      <div class="links">
        <a href="https://nuxtjs.org/" target="_blank" class="button--green">Documentation</a>
        <a href="https://github.com/nuxt/nuxt.js" target="_blank" class="button--grey">Github</a>
      </div>
      <button @click="test('1231')"> testButton </button>
    </div>
  </section>
</template>

<script>
import Logo from '~components/Logo.vue'

export default {
  components: {
    Logo
  },
  methods: {
    test: function (val) {
      console.log(val)
    }
  }
}

Missing URLs

nuxt/nuxt#1060

Server Side Rendering for components called from layouts

Hello ! on my site (https://yineo.fr/), my right sidebar is a component called from layouts/default.vue

Because i don't want to call it in every page component.

So my sidebar with last articles is not server side rendered and google bot can not see it ( see picture below, the left one is what google bot see and probably index )

How can i have server side rendering for my "Sidebar" Component called from layouts/default.vue ( code below the picture ) ?
thanks !

<!-- main layout -->
<template>
  <div>
    <AppNavigation />
    <AppHeader/>
  
    <div class="container">
      <div class="columns">
  
        <div class="column is-two-thirds">
          <nuxt/>
        </div>
  
        <div class="column">
          <section class="section">
            <TwitterFollowMe/>
            <hr/>
            <h2 class="title is-2">Derniers billets</h2>
            <PostsSidebar :posts="posts" />
          </section>
        </div>
  
      </div>
    </div>
    <AppFooter />
  </div>
</template>

<script>
import AppHeader from '~/components/AppHeader'
import AppNavigation from '~/components/AppNavigation'
import AppFooter from '~/components/AppFooter'
import TwitterFollowMe from '~/components/TwitterFollowMe'
import PostsSidebar from '~/components/PostsSidebar'
import { getPosts } from '~/services/wpContentApi'

export default {
  components: { AppHeader, AppNavigation, AppFooter, TwitterFollowMe, PostsSidebar },
  data () {
    return {
      posts: []
    }
  },
  async created () {
    this.posts = await getPosts(20)
  }
}
</script>

No ability to translate some hardcoded texts

Placeholder in search is hardcoded:
https://github.com/nuxt/nuxtjs.org/blob/master/components/Search.vue#L3

"Version" in affix is hardcoded:
https://github.com/nuxt/nuxtjs.org/blob/master/components/Affix.vue#L7

Will be great change that in docs-translations

The Affix can not scroll

I brower the nuxt(vue-store-documents)
The left nav can not be scroll
I remove the css styleoverflow-y: visible; on Affix.vue # line 139
Now is worked. 👍

Add .editorconfig & .eslintrc.js

there is a "undefined" text in the body

there is a undefined text in the body

How to support ie

my project in ie can not run

log said:

You are running Vue in development mode.
Make sure to turn on production mode when deploying for production.
See more tips at https://vuejs.org/guide/deployment.html
webpack-hot-middleware's client requires EventSource to work. You should include a polyfill if you want to support this browser: https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events#Tools
SCRIPT5022: [vuex] vuex requires a Promise polyfill in this browser.
vendor.bundle.js, 行44130 字符21

but，I don't kown the nustjs entry，where can I write

require("babel-polyfill");

Fix menu on /examples/

How to reproduce:

Go to https://nuxtjs.org/examples/ (or any example)
Click Middleware or i18n in the left menu.
Receive juicy 404
Reload window at current URL
Receive correct page for the example

FAQ - iOS Safari with phone number

Hi!
Now I'm working at commercial project with NuxtJS and I have met a very unhandy issue: site crashes at iOS Safari. I have spent several days trying to resolve this problem, and finally I have found the thing that broked down the whole site - it was a small phone number in the footer. What a suprise, mobile Safari turns all phone numbers it found into a link, like +7 (982) 536-50-77 renders into <a href="+7 (982) 536-50-77">+7 (982) 536-50-77</a>.

I even create an small and useless gist with componet for super lazy coders:
https://gist.github.com/queses/8b008a8b6f7b470cb0a8c5e1788d8c63

I believe it would be great, if you will create the FAQ topic with explanation of this very unoblivious problem.

With best regards!
Maxim Kobozev

No closing body and html tags

Hi.

Why generated html file does not contain </body></html> ?

Broken links when JS disabled

Great to see the doc online! Stumbled across a small issue which I think impacts SEO (and paranoïd users like myself):

Step by step

Disable Javascript in browser
Go to https://nuxtjs.org/
Click any relative link (like "Get Started")

Currently

The "Get Started" link will send me to https://guide/installation, while other relative links have similar effects

Expected

Links should have the same URLs as when JS is enabled (aka "https://nuxtjs.org/guide/installation" for the case of "Get Started")

Dynamic Component

Want to load component based on request

Here is my page

<template>
<Component :is="currentView"/>
</template>
<script>
export default {
   data () {
        return {currentView: '~/components/' + this.$route.query.country + '/content.vue'}
   }
}
</script>

I don't know how to do, but from above you may get an idea

How to make the animation of nuxtjs.org intro?

As the tittle says

I will like to get the animation intro of nuxtjs. I have try to copy the properties htm and css but it doesnt work

Thanks

Brazilian portuguese translation

@Atinux How can I go about translating this website to Brazilian portuguese? Just fork it and let you do the rest?

Dedicated Resources Page (Branding)

Related to nuxt/nuxt#1226

Change github button version in Homepage

nuxt/nuxt#495

redirect? docs?

Hi there!
Is there a possibility to specify redirects in Nuxt?
And if there is, is there any documentation for it?

HTTPS redirection

Well, me again.

Looks like links were fixed in #1 but now they lead to a page without a trailing /, which triggers a redirection... in HTTP (not "S").

So basically, any link you click brings you to the HTTP website. Kind of sad I think.

how can i use local json

async asyncData ({ params }) { let { data } = await axios.get('~static/test.json') return data }

errmsg:
(node:4796) UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 2): Error: connect ECONNREFUSED 127.0.0.1:80

Visit URL is not latest static infomation

I found this link
https://nuxtjs.org/guide/release-notes/

if you just visit this link , content show latest version is 0.10.5
but if you navigation to other page and back ( with js append content )
it's latest content ( v0.10.6 )

strange.... Don't know have other pages like this ....

Code font

is rendered like:

Maybe a proper monospace font is needed like

Redirect to previous page

Hello,

I was wondering, how can I redirect to the previous page with e.g. the nuxt-link?

Greetings,

Cannot deploy to AWS Elastic Beanstalk

Hello!

I'm trying to deploy the dist folder and my package.json to an EB instante but it's not working, some weird errors are showing related to NodeJS.

In this EB instance I have been deploying this same website but with VueJS 2 without NuxtJS but now I'm trying to deploy with the new structure using NuxtJS.

Do you have any idea?

search bar placement error

Hi there
some error with changing language

ru.nuxtjs.org site headers is good - in one line
nuxtjs.org headers are bad, search bar is out of line, can`t change lang

Search does not work on ja.nuxtjs.org, zh.nuxtjs.org and ko.nuxtjs.org

The search does not work on ja.nuxtjs.org, zh.nuxtjs.org, and ko.nuxtjs.org:

ReferenceError: window is not defined

Nuxt.js Error:

ReferenceError: window is not defined

index.vue:

listening on <nuxt-child> possible to pass events from nested routes?

is it possible to add event handlers to nuxt-child and fire events from nested pages?

nested.vue

<template>
  <nuxt-child @something="handle_something" />
</template>

nested/index.vue

<template>
  <button @click="$emit('something!')" >something</button>
</template>

when i use npm run dev is bad and npm run build && npm start is ok

when i clone the project and npm install
then use: npm run dev ,open the firefox http://localhost:3000

then I use npm run build && npm start
it's ok
---help

create a page for the 'context'

https://nuxtjs.org/api#context

I believe this section is important enough to have it's own navigational item on the left.

problem at middleware

If i write wrong proxy，check-auth was executed 3362 times in one request

code & result

Vue components in node_modules are not compiled on server-side

I created a simple package named myp:
nuxt.config.js

{
  ...[omitted],
  plugins: ['~/plugins/sample.js']
}

plugins/sample.js

import HisPlugin from 'myp'
Vue.component('HisPlugin', HisPlugin)

node_modules/myp/package.json

{
  ...[omitted],
  "main": "test.vue"
}

node_modules/myp/test.vue

<template>
  <div class="my-plugin">
    It works!
  </div>
</template>
<style>
.my-plugin {
  font-size: 200%;
}
</style>

And the following error message:

C:\Users\Daniel\Desktop\ssrtest\node_modules\myp\test.vue:1
(function (exports, require, module, __filename, __dirname) { <template>
                                                              ^
SyntaxError: Unexpected token <
    at createScript (vm.js:53:10)
    at Object.runInThisContext (vm.js:95:10)
    at Module._compile (module.js:543:28)

This presumably comes from the server-side renderer, which does not recognize *.vue files. Is it possible to get the server-side renderer to recognize them?

Some libraries export .vue files, and it is the recommended approach by Evan You (https://forum-archive.vuejs.org/topic/1203/how-to-bundle-a-set-of-vue-components-efficiently/4)

Vuex store behaviour when push back button in the browser

I've found that when you go back (browser back button) you lost the variables stored in vuex store. This happens because the code that initialized the vuex store (from the backend) gets executed again so the store is restarted. The normal behaviour appears to be that the store remains the same when you go back, like how it works on simple html inputs. So the question is, is there any configuration to preserve the store after going back or it is a bug?

Regards

Add hreflang meta

All /_nuxt/* files return 404 Not Found

Hi all,
I deployed my app in production , and start it using this command

pm2 start npm -- start

Nginx config for this app is

server_name MY_IP_ADDR;
location / {

 	 proxy_pass http://127.0.0.1:3000;
              proxy_http_version 1.1;
              proxy_set_header Upgrade $http_upgrade;
              proxy_set_header Connection 'upgrade';
              proxy_set_header Host $host;
              proxy_cache_bypass $http_upgrade;
 }

all is fine but i have this issue
all files under this uri #http://my-ip-addr/_nuxt/filename.[css|js], not found.

const fs = require('fs')
const https = require('https')
const app = require('express')()
const port = process.env.PORT || 80
const Nuxt = require('nuxt')
const config = require('./nuxt.config.js')
const nuxt = new Nuxt(config)
let options = {
  key: fs.readFileSync('/etc/pki/tls/private/localhost.key'),
  cert: fs.readFileSync('/etc/pki/tls/certs/localhost.crt')
}
app.get('/sitemap.xml', require('./xml/sitemap.js'))
app.use(nuxt.render)
https.createServer(options, app).listen(port, '0.0.0.0', function () {
  console.log('Started!')
})