Giter VIP home page Giter VIP logo

fluvio-website's Introduction

Fluvio Website

Public/Nightly Websites

Cloudflare Pages watches the default branch, and updates the live site automatically after merge

If you create branches in this repo (i.e., not on a fork), Cloudflare will build and provide a url to the Hugo site for each PR. Their URLS are dynamic, based on the name of your branch + .fluvio-website-preview.pages.dev

For more info read: https://developers.cloudflare.com/pages/platform/preview-deployments/#preview-aliases

Run Website on Local Machine

The website is generated using Hugo Framework. To run the website on your local machine:

  1. Install Hugo

  2. Run Hugo

    cargo run -- hugo 
  3. Website is rendered at

    http://localhost:1313/
    
  4. Checkout WRITERS.md for formatting and Fluvio customizations.

Hugo watches for file changes and automatically updates website.

Connector reference docs

A preview of the fluvio-cms CLI can be used to update the reference docs for connectors in the Hub.

Connectors are organized inscripts/fluvio-cms/src/connectors/mod.rs, and define:

  • Protocol used by connector
  • Direction of the data flow with respect to a Fluvio cluster.
  • Location in Hugo repo where connector README is stored
  • Location in Hugo repo where the content template is stored

At the time of this writing, the latest connector docs are collected by parsing the output of fluvio hub connector list

Add new connector docs

2 areas need to be updated before fluvio-cms will support a new connector's docs

  1. For new protocols, add to the DataService enum.
  2. For new connectors, add to the OfficialConnector enum

Update existing connector docs

Downloading from the public git repo:

Ex. Download MQTT docs from github repo

$ cargo run -- connector --service mqtt --direction inbound

Using README from local git clone:

Ex. Copy SQL docs

$ cargo run -- connector --service sql --direction outbound --file /path/to/README

CLI docs

Update help text

The list of CLI commands is located at /data/cli-commands.yml

Running this command will iterate through the list of CLI commands and capture the output of the --help flag

$ cargo run -- cli

This creates files in /embed/cli/help with the filename pattern <cmd>[-<subcmd1>][-<subcmd2][-subcmd3etc].md. The help output for the command fluvio cluster list would be located at /embed/cli/help/fluvio-cluster-list.md

The templates for the CLI pages in https://www.fluvio.io/cli/ are not generated. Any commands that are added or removed may need to modify additional files.

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.