Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lightyourjourney/notes-archive

Where LYJ keeps his notes.
https://github.com/lightyourjourney/notes-archive

blog mkdocs mkdocs-material notes python static-site

Last synced: 3 days ago
JSON representation

Where LYJ keeps his notes.

Awesome Lists containing this project

README

        

LYJ's Notebook

English | [įŽ€äŊ“中文](./README.zh-CN.md)

[![Auth](https://img.shields.io/badge/Auth-LYJ-ff69b4)](https://github.com/LightYourJourney)
[![GitHub Issues](https://img.shields.io/github/issues/LightYourJourney/notes-archive.svg)](https://github.com/LightYourJourney/notes-archive/issues)
[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/LightYourJourney/notes-archive)](https://github.com/LightYourJourney/notes-archive/pulls)
[![GitHub Pull Requests](https://img.shields.io/github/stars/LightYourJourney/notes-archive)](https://github.com/LightYourJourney/notes-archive/stargazers)
[![GitHub license](https://img.shields.io/github/license/LightYourJourney/notes-archive)](https://github.com/LightYourJourney/notes-archive/blob/main/LICENSE)
[![HitCount](https://views.whatilearened.today/views/github/LightYourJourney/notes-archive.svg)](https://github.com/LightYourJourney/notes-archive)




This is a **very rough** [online public notebook 📝](https://notes.yanjinli.fun/), mainly used to record and back up things learned daily.

This notebook is built using [MkDocs](https://www.mkdocs.org/) and uses the [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) theme. The Chinese font is [LXGW WenKai Screen](https://github.com/lxgw/LxgwWenKai-Screen), and the English font is [JetBrains Mono](https://www.jetbrains.com/lp/mono/).

Welcome to Fork and Star, and feel free to raise Issues and PRs!

## Online Reading

This project is hosted on GitHub Pages and can be read online at [https://notes.yanjinli.fun/](https://notes.yanjinli.fun/).

## Local Build and Deployment

If you want to build and deploy this project locally, you can follow these steps:

First, make sure you have [Python](https://www.python.org/) and [pip](https://pypi.org/project/pip/) installed.

1. Clone the project locally and switch to the project directory:

```bash
git clone https://github.com/LightYourJourney/notes-archive.git
cd notes-archive
```

2. Create and activate a virtual environment:

```bash
python3 -m venv venv # Create a virtual environment
. venv/bin/activate # Activate the virtual environment (Linux, macOS)
# or
.\env\Scripts\activate # Activate the virtual environment (Windows)
```

3. Install dependencies:

```bash
pip install -r requirements.txt
```

4. Build and start the project:

```bash
mkdocs serve
```

5. Preview in the browser

Open your browser and enter `http://127.0.0.1:8000/notes-archive/` to preview.

## Project Status

![Repo Status](https://repobeats.axiom.co/api/embed/e8e3ef5e020b4705bb7d326cbe97114fad81d3db.svg)

## Statement

All articles in this notebook adhere to the [Chinese Technical Documentation Writing Standards](https://github.com/ruanyf/document-style-guide).

## Permission

This notebook is available freely under [the CC BY-SA 4.0 license](https://creativecommons.org/licenses/by-sa/4.0/). See more details in [LICENSE](./LICENSE).