lost-stats.github.io 的安装和配置教程

1. 项目的基础介绍和主要的编程语言

lost-stats.github.io 是一个开源项目，旨在构建一个名为 Library of Statistical Techniques (LOST) 的网站，该网站的目标是使得执行统计技术变得简单易行。它是一个公开可编辑的网站，用户可以在这里找到各种统计软件的统计技术实现。

该项目主要使用的编程语言包括：

• Python：用于后端逻辑处理和自动化测试。
• Ruby：用于网站的构建和部署，使用的是 Jekyll 静态网站生成器。
• SCSS：用于样式表的编写。
• R：用于统计分析和数据处理。
• HTML：用于网页的基本结构。

2. 项目使用的关键技术和框架

该项目使用以下关键技术和框架：

• Jekyll：一个静态网站生成器，它将纯文本文件转换成一个完整的网站，无需数据库和服务器端逻辑。
• Docker：用于创建隔离的运行环境，以便安全地运行测试代码。
• pytest：一个成熟的全功能Python测试框架。
• py.test-xdist：pytest的插件，用于并行测试。
• mistune：一个快速的Markdown解析库。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统中已经安装了以下依赖：

• Ruby 2.6.4
• Docker
• Python 3.8 或更高版本

安装步骤

1. 克隆项目仓库到本地：

   git clone https://github.com/LOST-STATS/lost-stats.github.io.git
   cd lost-stats.github.io
   

2. 安装 Ruby 依赖：

   gem install bundler
   bundle install
   

3. 构建和运行网站：

   bundle exec jekyll serve
   

   运行上述命令后，您的网站将在本地 http://127.0.0.1:4000/ 上启动。

4. 安装 Python 虚拟环境并安装测试依赖：

   python3 -m venv venv
   source venv/bin/activate
   pip install mistune py.test pytest-xdist
   

5. 拉取 Docker 镜像：

   docker pull ghcr.io/lost-stats/lost-docker-images/tester-r
   docker pull ghcr.io/lost-stats/lost-docker-images/tester-python
   

6. 运行测试：

   source venv/bin/activate
   py.test test_samples.py
   

   如果需要运行特定目录下的测试，可以使用 --mdpath 参数，例如：

   py.test test_samples.py --mdpath Time_Series --mdpath Presentation
   

7. 如果需要并行运行测试，可以添加 -n 参数：

   py.test test_samples.py -n 3 --mdpath Time_Series
   

按照以上步骤，您应该能够成功安装和配置 lost-stats.github.io 项目，并开始本地开发。