mirror of
https://github.com/rowboatlabs/rowboat.git
synced 2026-05-02 11:52:38 +02:00
update docs, add dockerfile
This commit is contained in:
parent
13bc8600c6
commit
cdc96e7ce3
6 changed files with 83 additions and 17 deletions
11
apps/docs/Dockerfile
Normal file
11
apps/docs/Dockerfile
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
FROM python:3.12
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
COPY requirements.txt .
|
||||
|
||||
RUN pip install -r requirements.txt
|
||||
|
||||
COPY . .
|
||||
|
||||
CMD ["mkdocs", "serve", "--dev-addr", "0.0.0.0:8000"]
|
||||
|
|
@ -1,17 +1,5 @@
|
|||
# Welcome to MkDocs
|
||||
# Welcome to Rowboat
|
||||
|
||||
For full documentation visit [mkdocs.org](https://www.mkdocs.org).
|
||||
Welcome to the official documentation for Rowboat. Rowboat is an open-source project that helps you build, test, and deploy AI applications.
|
||||
|
||||
## Commands
|
||||
|
||||
* `mkdocs new [dir-name]` - Create a new project.
|
||||
* `mkdocs serve` - Start the live-reloading docs server.
|
||||
* `mkdocs build` - Build the documentation site.
|
||||
* `mkdocs -h` - Print help message and exit.
|
||||
|
||||
## Project layout
|
||||
|
||||
mkdocs.yml # The configuration file.
|
||||
docs/
|
||||
index.md # The documentation homepage.
|
||||
... # Other markdown pages, images and other files.
|
||||
You can find the source code on GitHub at [@rowboatlabs/rowboat](https://github.com/rowboatlabs/rowboat/).
|
||||
|
|
|
|||
55
apps/docs/readme.md
Normal file
55
apps/docs/readme.md
Normal file
|
|
@ -0,0 +1,55 @@
|
|||
# Documentation Site
|
||||
|
||||
This documentation site is built using [MkDocs Material](https://squidfunk.github.io/mkdocs-material/), a modern documentation framework that creates beautiful and functional static sites.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Python 3.x
|
||||
- pip (Python package manager)
|
||||
|
||||
## Setup
|
||||
|
||||
Install the required dependencies:
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
## Development
|
||||
|
||||
To run the documentation site locally:
|
||||
|
||||
```bash
|
||||
mkdocs serve
|
||||
```
|
||||
|
||||
This will start a local server, and you can view the documentation site at `http://localhost:8000`.
|
||||
|
||||
### Building the static site
|
||||
|
||||
To build the static site:
|
||||
|
||||
```bash
|
||||
mkdocs build
|
||||
```
|
||||
|
||||
This will generate the static site in the `site` directory.
|
||||
|
||||
### Project structure
|
||||
|
||||
- `mkdocs.yml`: The main configuration file for MkDocs.
|
||||
- `docs/`: The directory containing the Markdown files for the documentation.
|
||||
- `site/`: The directory generated by the `mkdocs build` command, containing the static site files.
|
||||
|
||||
## Writing Documentation
|
||||
|
||||
- Documentation files are written in Markdown format
|
||||
- Place new documentation files in the `docs` directory
|
||||
- Update `mkdocs.yml` to include new pages in the navigation
|
||||
|
||||
## Additional Resources
|
||||
|
||||
- [Mkdocs documentation](https://www.mkdocs.org/getting-started/)
|
||||
- [MkDocs Material Documentation](https://squidfunk.github.io/mkdocs-material/getting-started/)
|
||||
- [Markdown Guide](https://www.markdownguide.org/basic-syntax/)
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue