Skip to content

Commit e3cec90

Browse files
committed
wip
1 parent 82b02a0 commit e3cec90

File tree

3 files changed

+12
-7
lines changed

3 files changed

+12
-7
lines changed

en/README.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Vue.js Server-Side Rendering Guide
22

3-
## What is SSR?
3+
## What is Server-Side Rendering (SSR)?
44

55
Vue.js is a framework for building client-side applications. By default, Vue components produce and manipulate DOM in the browser as output. However, it is also possible to render the same components into HTML strings on the server, send them directly to the browser, and finally "hydrate" the static markup into a fully interactive app on the client.
66

@@ -26,6 +26,4 @@ There are also some trade-offs to consider when using SSR:
2626

2727
Before using SSR for your app, the first question you should ask it whether you actually need it. It mostly depends on how important time-to-content is for your app. For example, if you are building an internal dashboard where an extra few hundred milliseconds on initial load doesn't matter that much, SSR would be an overkill. However, in cases where time-to-content is absolutely critical, SSR can help you achieve the best possible initial load performance.
2828

29-
We realize it could be quite challenging to build a server-rendered Vue app if you are not already familiar with webpack, Node.js and Vue itself. If you prefer a higher-level solution that provides a smoother on-boarding experience, you should probably give [Nuxt.js](http://nuxtjs.org/) a try. It's built upon the same Vue stack but abstracts away a lot of the complexities, and provides some extra features such as static site generation. However, it may not suit your use case if you need more direct control of your app's structure. And it would still be beneficial to read through this guide to better understand how things work together.
30-
3129
If you believe your use case justifies the use of SSR, then let's dive in!

en/basic.md

+4
Original file line numberDiff line numberDiff line change
@@ -51,3 +51,7 @@ app.get('*', (req, res) => {
5151
```
5252

5353
This is the most basic API to render a Vue app on the server. However, this is far from sufficient for a real world server-rendered app. In the following chapters we will cover the common issues encountered and how to deal with them.
54+
55+
As you read along, it would also be helpful to refer to the official [HackerNews Demo](https://github.com/vuejs/vue-hackernews-2.0/), which makes use of most of the techniques covered in this guide.
56+
57+
We also realize it could be quite challenging to build a server-rendered Vue app if you are not already familiar with webpack, Node.js and Vue itself. If you prefer a higher-level solution that provides a smoother on-boarding experience, you should probably give [Nuxt.js](http://nuxtjs.org/) a try. It's built upon the same Vue stack but abstracts away a lot of the complexities, and provides some extra features such as static site generation. However, it may not suit your use case if you need more direct control of your app's structure. And it would still be beneficial to read through this guide to better understand how things work together.

en/bundle-renderer.md

+7-4
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,13 @@
44

55
In our basic usage example, we directly required Vue and created an app instance in our Node.js server code. This is straightforward, however has quite a few issues in practice:
66

7-
- webpack
8-
- development and deployment
9-
- source map
10-
- code splitting
7+
- **Build Tool Integration:**
8+
9+
- **Source Map:**
10+
11+
- **Development and Deployment:**
12+
13+
- **Code Splitting:**
1114

1215
## Enter BundleRenderer
1316

0 commit comments

Comments
 (0)