Giter VIP home page Giter VIP logo

dubbo-website's Introduction

Dubbo Official Website

CI Status

This project keeps all sources used for building up Dubbo official website which's served at https://dubbo.apache.org.

Overview

The Apache Dubbo docs are built using Hugo with the Docsy theme.

This project contains the markdown source files of the Dubbo documentation.

Pre-requisites

Environment setup

You can directly start working on this repository even from your browser by just clicking on the following button

Open in Gitpod

Or, you can follow the manual steps given below.

  1. Ensure pre-requisites are installed
  2. Clone this repository
git clone https://github.com/apache/dubbo-website.git
  1. Install PostCSS required by Docsy by running the following commands from the root directory of your project:
$ npm install --save-dev autoprefixer
$ npm install -D postcss
$ npm install --save-dev postcss-cli

Run server locally

  1. Clear up your local module cache
hugo mod clean
  1. Start the server
hugo server --disableFastRender
# If you get stuck with 'hugo: downloading modules …' after running this command, please try to set GOPROXY by running `export GOPROXY="https://goproxy.cn|https://proxy.golang.com.cn"` and try again.
  1. Navigate to http://localhost:1313

Update docs

  1. Create new branch
  2. Commit and push changes to content
  3. Submit pull request to master branch
  4. Staging site will automatically get created and linked to PR to review and test

dubbo-website's People

Contributors

albumenj avatar alexstocks avatar asa3311 avatar baerwang avatar beiwei30 avatar burningcn avatar chickenlj avatar cnjxzhao avatar conghuhu avatar crazyhzm avatar diaoxiong avatar dongzl avatar guohao avatar horizonzy avatar htynkn avatar icefoxs avatar joecqupt avatar keran213539 avatar laurencelizhixin avatar lqllulu avatar mfordjody avatar namelessssssssssss avatar phixsura avatar plusmancn avatar songxiaosheng avatar wangchengming666 avatar win120a avatar wxbty avatar xiaoheng1 avatar yuchang01 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

dubbo-website's Issues

文档"dubbo需求"的一个错别字

https://github.com/apache/incubator-dubbo-website/blob/asf-site/docs/zh-cn/user/preface/requirements.md
"...并在加大的过程中记录响应时间的变化,直到响应时间到达阀值,记录此时的访问量.."
根据第七版现代汉语词典的解释, 阀字开头词语所有的仅有 "阀阅"/"阀门", 阀字在其中的意思分别是大家族/开关.
v2-1b5a2d0ef9cd24e0f4dd12ddcec937de_r
阀值是阈值的别字. 阈值 threshold, 阈字指门槛/国门/泛指界限或范围. 二者并非可通用的词汇, 也没有网上以讹传讹所谓咬文嚼字加入词典一说.

Add company name beneath company logo

In the "who is using Dubbo" section, there are many logos, but people may not know which company these logo represent.

We need to add company name for each logo.

The default size of the services' Thread Pool(Fixed) is 200

The default size of the services' Thread Pool(Fixed) is 100 in user manual, but the source code of FixedThreadPool is 200. There are inconsistent.

1. desc of user manual

dubbo-protocol.mddubbo-provider.md

| 属性 | 对应URL参数 | 类型 | 是否必填 | 缺省值 | 作用 | 描述 | 兼容性 |
| threads | threads | int | 可选 | 100 | 性能调优 | 服务线程池大小(固定大小) | 2.0.5以上版本 |

| Attribute     | Corresponding URL parameter | Type           | Required    | Default Value                            | Function                  | Description                              | Compatibility |
| threads       | threads                     | int            | False       | 100                                      | Performance optimize      | The size of the services' Thread Pool(Fixed) | Above 2.0.5   |

2. source code of FixedThreadPool

org.apache.dubbo.common.Constants

    public static final String DEFAULT_THREAD_NAME = "Dubbo";

    public static final int DEFAULT_CORE_THREADS = 0;

    public static final int DEFAULT_THREADS = 200;

org.apache.dubbo.common.threadpool.support.fixed.FixedThreadPool

public class FixedThreadPool implements ThreadPool {

    @Override
    public Executor getExecutor(URL url) {
        String name = url.getParameter(Constants.THREAD_NAME_KEY, Constants.DEFAULT_THREAD_NAME);
        int threads = url.getParameter(Constants.THREADS_KEY, Constants.DEFAULT_THREADS);
        int queues = url.getParameter(Constants.QUEUES_KEY, Constants.DEFAULT_QUEUES);
        return new ThreadPoolExecutor(threads, threads, 0, TimeUnit.MILLISECONDS,
                queues == 0 ? new SynchronousQueue<Runnable>() :
                        (queues < 0 ? new LinkedBlockingQueue<Runnable>()
                                : new LinkedBlockingQueue<Runnable>(queues)),
                new NamedInternalThreadFactory(name, true), new AbortPolicyWithReport(name, url));
    }

}

Redis doc contains error discription

2. 服务消费方启动时,从 Channel:/dubbo/com.foo.BarService/providers 订阅 register 和 unregister 事件
3.并向 Key:/dubbo/com.foo.BarService/providers 下,添加当前消费者的地址

should be change to :

2. 服务消费方启动时,从 Channel:/dubbo/com.foo.BarService/providers 订阅 register 和 unregister 事件
3.并向 Key:/dubbo/com.foo.BarService/consumers 下,添加当前消费者的地址

show the blog or doc title

When share blog or docs on wechat moment, it can't show the blog/docs title

It's recommended setting the title to page's <title> element.

image

docsite build failed both on Windows&MacOS.

D:\git\alibaba\incubator-dubbo-website>docsite build
C:\Users\kk\AppData\Roaming\npm\node_modules\docsite\lib\generateJSONFile.js:23
...result.meta,
^^^

SyntaxError: Unexpected token ...
at createScript (vm.js:74:10)
at Object.runInThisContext (vm.js:116:10)
at Module._compile (module.js:533:28)
at Object.Module._extensions..js (module.js:580:10)
at Module.load (module.js:503:32)
at tryModuleLoad (module.js:466:12)
at Function.Module._load (module.js:458:3)
at Module.require (module.js:513:17)
at require (internal/module.js:11:18)
at Object. (C:\Users\kk\AppData\Roaming\npm\node_modules\docsite\lib\start.js:5

D:\git\alibaba\incubator-dubbo-website>npm run build

[email protected] build D:\git\alibaba\incubator-dubbo-website
rm -rf build && gulp build

[23:31:33] Using gulpfile D:\git\alibaba\incubator-dubbo-website\gulpfile.js
[23:31:33] Starting 'webpack:build'...
[BABEL] Note: The code generator has deoptimised the styling of "D:/git/alibaba/incubator-dubb
n" as it exceeds the max of "500KB".
[23:31:43] [webpack:build] Hash: 593f6334db0e3d48cde4
Version: webpack 2.7.0
Time: 9286ms
Asset Size Chunks Chunk Names
3769542dc85a905d2f4a.js 1.43 MB 0 [emitted] [big]
1ecbed914a98e77c9bc7.js 250 kB 1 [emitted] [big]
acbc28a1725c85d6763d.js 78.4 kB 2 [emitted]

Blog translation, round 2.

We have received lots of help from the community on blog translation previously, see #66 . Thank you all for the hard work.

Here are more blogs that you can contribute on.

Part 1
如何准备一次Apache发布

Part 2
通过QoS对服务进行动态控制

Part 3
从跨语言调用到dubbo2.js

Part 4
Dubbo的同步和异步调用

Part 5
Dubbo基本用法-Dubbo Provider配置

Part 6
Spring-boot+Dubbo应用启停源码分析

Part 7
Dubbo可扩展机制源码解析

Part 8
Dubbo的泛化调用

Part 9
Dubbo的负载均衡

Part 10
如何基于Dubbo实现全异步调用链

doc is

docs right part Not Displayed !
down incubator-dubbo-website/asf-site
run : docsite start
click docs page right part not showd

tip:

sidemenu show,but right part content is blank

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.