quarto2forge/jupyter

Docker镜像文档

镜像概述

该Docker镜像集成了Quarto、LaTeX、LibreOffice、Python、R及Jupyter Lab等多种工具，旨在为用户提供一站式的文档编写、数据分析与科学计算环境。无需单独安装和配置各组件，可直接部署使用，大幅简化多工具协同工作的环境搭建流程。

核心功能与特性

• Quarto：支持Markdown、LaTeX等格式的技术文档编写与多平台发布（PDF、HTML、Word等）
• LaTeX：提供专业排版能力，适用于学术论文、技术报告等高质量文档生成
• LibreOffice：支持办公文档（Word、Excel、PowerPoint等）的创建与编辑
• Python & R：集成主流数据分析与科学计算语言，支持数据处理、统计分析与可视化
• Jupyter Lab：提供交互式编程环境，支持Python、R等语言的代码编写、运行与结果展示

使用场景与适用范围

• 学术研究：论文写作（LaTeX/Quarto）、数据分析（Python/R）与结果可视化
• 数据科学：通过Jupyter Lab进行交互式数据分析、模型开发与代码调试
• 技术文档：使用Quarto生成多格式技术文档，结合LibreOffice进行文档编辑
• 教学环境：快速搭建包含多种工具的教学环境，满足编程、数据分析、文档编写教学需求

使用方法与配置说明

基本运行命令

bash
docker run -d -p 8888:8888 -v /本地工作目录:/workspace --name quarto-env 镜像名称

参数说明：

• -d：后台运行容器
• -p 8888:8888：映射Jupyter Lab默认端口（主机端口:容器端口）
• -v /本地工作目录:/workspace：挂载本地目录至容器内工作空间，实现文件持久化
• --name quarto-env：指定容器名称

访问Jupyter Lab

1. 运行容器后，通过docker logs quarto-env获取Jupyter Lab访问链接（包含token）
2. 在浏览器中访问http://localhost:8888，输入日志中的token即可进入Jupyter Lab界面

环境变量配置

可通过环境变量自定义配置：

示例（指定Jupyter访问密码）：

bash
docker run -d -p 8888:8888 -e JUPYTER_TOKEN=yourpassword -v /本地工作目录:/workspace --name quarto-env 镜像名称

工具使用示例

使用Quarto生成文档

在Jupyter Lab终端中执行：

bash
# 创建Quarto文档
quarto create mydoc.qmd

# 编辑文档后渲染为PDF
quarto render mydoc.qmd --to pdf

使用Python/R进行数据分析

在Jupyter Lab中创建Python或R笔记本，直接编写代码进行数据分析与可视化。

使用LaTeX编译论文

在工作目录中放置LaTeX源文件（.tex），通过终端执行：

bash
pdflatex paper.tex