Tableau is the world's leading end-to-end data and analytics platform.
Leverage the analytical powerhouse of Tableau to analyze and visualize data. This guide teaches you how to compose Tableau's varied product capabilities into applications that thrill customers, coworkers and friends!
Beyond creating visual representations of data, Tableau provides the greatest benefits as it helps people discover what information is valuable to others. It enables users to analyze data and build the interfaces that represent them with unmatched speed and flexibility resulting in a springboarding of ideas into value.
To see the live app go to Embed Tableau.
-
First, clone this GitHub repository using your method of choice.
-
Then, navigate to the directory where you cloned the repository using your shell.
cd embedding_playbook
- Install dependencies (look for a file called
package.json
for more details).
npm install
- Create local environment files to store your credentials by copying the provided template.
# copy the development template
cp ./.env.development ./.env.development.local
cp ./.env.production ./.env.production.local
-
Provide values for all environment variables listed in
.env.development.local
&.env.production.local
. -
Finally, start the development server (see USAGE.md for more shell scripts).
npm run dev
- From this point forward, any changes made to files in the codebase will be previewed live in development mode, noticeable in particular will be changes to React components (
.jsx
files) or Markdown articles (.mdx
or.md
files).
Visit localhost:3000
to see the app. Enjoy!
For more detailed installation instructions refer to INSTALLATION.md to learn about production deployments.
To learn more about developer scripts that run this application go to USAGE.md.
NOTE: Development on GitHub codespaces may differ from this process. Please refer to their documentation for further guidance.
Contributing to new or existing articles is done by editing .mdx
files located in the pages/
folder. The folder structure of pages/
dictates the overall layout of the application which can be further customized via _meta.json
files placed inside each folder. This architecture is designed and maintained by Nextra which documents all available options for organizing content.
Refer to this guide for help with Markdown Syntax such as tables, quotes and more. These provide the basics elements that make up the Markdown language.
To embed a Tableau visualization you must first import the <TableauViz>
component into the .mdx
article that you are writing and provide the attributes that it needs to display your analytics.
import { TableauViz } from 'components';
# Embedding Tableau Visualizations
This is *generic* markdown content preceding the **Tableau** component of interest.
[Link Text](URL)
Notice the following attributes provided for a visualization
hosted for free on Tableau Public:
<TableauViz
src='https://public.tableau.com/views/{viz}'
height='900'
width='700'
hideTabs='true'
device='default'
isPublic
/>
Another block of text and an *image* can go after the embed.
![Alt Text](Image URL)
For more information on writing articles, adding images and displaying interactive components such as a Tableau visualization refer to STYLE_GUIDE.md.
You are welcome customize this app and use it to conduct demonstrations of embedded analytics using Tableau. In other words, you can modify the styles and content of the app so it matches your own brand standard and portrays the analytics use case you have in mind.
To learn more about building custom demos using this application please visit DEMOS.md for instructions on working with configuration files.
This application follows a "docs-as-code" model of development incorporating a powerful UI framework which interfaces with Markdown as the language of content, this helps developers and analysts collaborate with the community at-large and more importantly to keep up with the pace of change.
For more information describing the overall architecture of this application as well as it's purpose and inspiration refer to ABOUT.md.
Contributions to this project are more than welcome and may come in the form of enhancements to the codebase, writing articles, correcting or identifying bugs or even suggesting improvements.
For more information please refer to the CONTRIBUTING.md.
This project is licensed under the MIT License.