Giter Club home page Giter Club logo

young-datafan-website's Introduction

DataFan Website

License

English | 中文

这是包含 http://www.young-datafan.com 的所有源代码的存储库。 本指南将指导您如何为young-datafan的网站做出贡献。

分支

develop 为默认主分支,修改请先fork到自己的仓库,然后在main分支上进行开发修改。

develop  默认分支

1.预览并生成静态文件

本网站是使用node编译的,使用的是Docusaurus框架组件

  1. 下载并安装 nodejs(version>12.5.0)
  2. 克隆代码到本地 git clone [email protected]:young-datafan/young-datafan-website.git
  3. 运行 npm install 来安装所需的依赖库。
  4. 在根目录运行npm run start,可以访问http://localhost:3000 查看站点英文模式预览
  5. 在根目录运行npm run start-zh,可以访问http://localhost:3000 查看站点的中文模式预览
  6. 要生成静态网站资源文件,运行 npm run build。构建的静态资源在build目录中。

2.目录结构

|-- docs-data-integration   // 集成平台介绍
|-- docs-data-studio        // 数据开发平台介绍
|-- docs-datafan-report     // 数据可视化平台介绍
|-- docs-sqlbuilder         // SqlBuilder工具介绍
|-- download //下载
|-- faq      //Q&A
|-- i18n    
|   -- zh-CN  //国际化中文
|       |-- code.json
|       |-- docusaurus-plugin-content-docs
|       |-- docusaurus-plugin-content-docs-community
|       |-- docusaurus-plugin-content-docs-download
|       |-- docusaurus-plugin-content-docs-faq
|        -- docusaurus-theme-classic
|-- resource // 架构/时序/流程图等的原始工程文件
|-- src
|   |-- components
|   |-- css
|   |-- js
|   |-- pages
|   |   |-- home
|   |   |-- index.jsx
|   |   |-- team
|   |   |-- user
|   |-- styles
|-- static //静态资源
|   |-- doc  //文档的静态资源
|        |-- image //文档通用图片
|        |-- image_en //英文文档图片
|        |-- image_zh //中文文档图片
|   |-- user //用户的图片
|   |-- home //首页的图片
|   |-- image  //模块公用图片
|-- docusaurus.config.js

3.规范

3.1 目录命名规范

全部采用小写方式, 以中下划线分隔,有复数结构时,要采用复数命名法, 缩写不用复数

正例: scripts / styles / components / images / utils / layouts / demo_styles / demo-scripts / img / doc

反例: script / style / demoStyles / imgs / docs

3.2 javascript 以及静态资源文件命名规范

全部采用小写方式, 以中划线分隔

正例: render-dom.js / signup.css / index.html / company-logo.png

反例: renderDom.js / UserManagement.html

3.3 资源路径

图片资源统一放在static/{模块名}

css等样式文件放在src/css目录下

3.4 页面内容修改

除了首页、团队、用户、Docs>All Version 模块页面外,其余页面都能通过底部的'Edit this page'按钮 直接跳转至对应的github的资源修改页

3.5 首页页面修改

访问页面 http://www.young-datafan.com 位于 src/pages/home

├─home
│      languages.json 首页中英文的配置  
│      index.less  首页样式

3.6 团队页面修改

访问页面 http://www.young-datafan.com/team 位于 src/pages/team

├─team
│ languages.json
│ index.js
│ index.less

young-datafan-website's People

Contributors

zhangrenhua avatar

Stargazers

echo avatar  avatar 刘俊 avatar

Watchers

 avatar Vincent Hsing avatar  avatar

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.