Skip to content

Commit 3395e92

Browse files
committed
🎨 format markdown README
1 parent af21ebc commit 3395e92

File tree

1 file changed

+8
-9
lines changed

1 file changed

+8
-9
lines changed

README.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
| Information | Links |
88
| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
99
| **Package** | [![PyPI Latest Release](https://img.shields.io/pypi/v/vuegen.svg)][vuegen-pypi] [![Conda Latest Release](https://img.shields.io/conda/v/bioconda/vuegen.svg)][vuegen-conda] [![Supported versions](https://img.shields.io/pypi/pyversions/vuegen.svg)][vuegen-pypi] [![Docker Repository on Quay](https://quay.io/repository/dtu_biosustain_dsp/vuegen/status "Docker Repository on Quay")][vuegen-docker-quay] [![License](https://img.shields.io/github/license/Multiomics-Analytics-Group/vuegen)][vuegen-license] |
10-
| **Documentation** | [![View - Documentation](https://img.shields.io/badge/view-Documentation-blue?style=flat)][vuegen-docs] [![made-with-sphinx-doc](https://img.shields.io/badge/Made%20with-Sphinx-1f425f.svg)](https://www.sphinx-doc.org/) ![Docs](https://readthedocs.org/projects/vuegen/badge/?style=flat) |
10+
| **Documentation** | [![View - Documentation](https://img.shields.io/badge/view-Documentation-blue?style=flat)][vuegen-docs] [![made-with-sphinx-doc](https://img.shields.io/badge/Made%20with-Sphinx-1f425f.svg)](https://www.sphinx-doc.org/) ![Docs](https://readthedocs.org/projects/vuegen/badge/?style=flat) |
1111
| **Build** | [![CI](https://github.com/Multiomics-Analytics-Group/vuegen/actions/workflows/cdci.yml/badge.svg)][ci-gh-action] [![Docs](https://github.com/Multiomics-Analytics-Group/vuegen/actions/workflows/docs.yml/badge.svg)][ci-docs] |
1212
| **Examples** | [![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?style=for-the-badge&logo=html5&logoColor=white)][emp-html-demo] [![Streamlit](https://img.shields.io/badge/Streamlit-%23FE4B4B.svg?style=for-the-badge&logo=streamlit&logoColor=white)][emp-st-demo] |
1313
| **Discuss on GitHub** | [![GitHub issues](https://img.shields.io/github/issues/Multiomics-Analytics-Group/vuegen)][issues] [![GitHub pull requests](https://img.shields.io/github/issues-pr/Multiomics-Analytics-Group/vuegen)][pulls] |
@@ -129,7 +129,7 @@ vuegen --directory docs/example_data/Earth_microbiome_vuegen_demo_notebook --rep
129129
130130
### Folder structure
131131

132-
Your input directory should follow a **nested folder structure**, where first-level folders are treated as **sections** and second-level folders as **subsections**, containing the components (plots, tables, networks, Markdown text, and HTML files). If the component files are in the first-level folders, an `overview` subsection will be created automatically.
132+
Your input directory should follow a **nested folder structure**, where first-level folders are treated as **sections** and second-level folders as **subsections**, containing the components (plots, tables, networks, Markdown text, and HTML files). If the component files are in the first-level folders, an `overview` subsection will be created automatically.
133133

134134
Here is an example layout:
135135

@@ -245,15 +245,15 @@ The **bundle GUI** with the VueGen package is available under the
245245
You will need to unzip the file and run `vuegen_gui` in the unpacked main folder.
246246
Most dependencies are included into the bundle using [PyInstaller][pyinstaller].
247247

248-
Streamlit works out of the box as a purely Python based package. For the rest of report types you
248+
Streamlit works out of the box as a purely Python based package. For the rest of report types you
249249
will have to have a **Python 3.12** installation with the `jupyter` package installed, as `quarto` needs to start
250250
a kernel for execution. This is also true if you install `quarto` globally on your machine.
251251

252252
> [!TIP]
253253
> It is advisable to create a virtual environment to manage depenendencies and avoid conflicts with existing packages. You can use the virtual environment manager of your choice, such as `poetry`, `conda`, or `pipenv`. We recommend using [miniforge][conda-download] to install Python and the `conda` package manager.
254254
255-
We assume you have installed the `miniforge` distribution for your machine (MacOS with arm64/ apple silicon
256-
or x86_64/ intel or Windows x86_64). Also, download the
255+
We assume you have installed the `miniforge` distribution for your machine (MacOS with arm64/ apple silicon
256+
or x86_64/ intel or Windows x86_64). Also, download the
257257
[latest `vuegen_gui` bundle](https://github.com/Multiomics-Analytics-Group/vuegen/releases/latest)
258258
from the releases page according to your operating system.
259259

@@ -326,11 +326,10 @@ This advanced case study demonstrates the application of VueGen in a real-world
326326
327327
### 3. ChatBot Component
328328

329-
This case study highlights VueGen’s capability to embed a chatbot component into a report subsection,
330-
enabling interactive conversations inside the report. This component is streamlit-specific and is not
329+
This case study highlights VueGen’s capability to embed a chatbot component into a report subsection,
330+
enabling interactive conversations inside the report. This component is streamlit-specific and is not
331331
available for other report types.
332332

333-
334333
Two API modes are supported:
335334

336335
- **Ollama-style streaming chat completion**
@@ -359,7 +358,7 @@ to support more flexible and general-purpose response formats in future releases
359358

360359
Once a Streamlit report is generated, it can be deployed as a web application to make it accessible online. There are multiple ways to achieve this:
361360

362-
### Streamlit Community Cloud
361+
### Streamlit Community Cloud
363362

364363
Deploy your report easily using [Streamlit Cloud][st-cloud], as demonstrated in the [EMP VueGen Demo][emp-st-demo]. The process involves moving the necessary scripts, data, and a requirements.txt file into a GitHub repository. Then, the app can be deployed via the Streamlit Cloud interface. The deployment example is available in the `streamlit-report-example` branch.
365364

0 commit comments

Comments
 (0)