Compare commits

...

10 Commits

Author SHA1 Message Date
pxiaoer
64f1f9c325 update readme 2025-07-09 18:05:46 +08:00
P小二
1f3f0f241e 优化页面结构:移除README文件中的Front Matter,改为在配置文件中统一管理页面元数据 2025-07-09 17:31:17 +08:00
P小二
11680f471d 修复代码中的中文注释和配置文件中的中文内容,全部替换为英文 2025-07-09 17:24:51 +08:00
P小二
1751af60ca 添加Python for LLM分类到中文版,完善导航结构 2025-07-09 17:17:05 +08:00
P小二
40e8a01387 优化导航描述:使导航标题更加清晰和描述性 2025-07-09 17:16:42 +08:00
P小二
82e5708992 修正导航结构:将Quick Navigation移到最前面,修正分类标题层级和导航链接 2025-07-09 17:15:53 +08:00
P小二
096549daa7 完成内容结构重组:修正所有分类标题和编号 2025-07-09 17:06:33 +08:00
P小二
c0db980f78 重新组织内容结构:将Github Top 45移到最前面,所有分类作为子分类 2025-07-09 17:04:57 +08:00
P小二
ace3b9d470 feat: move stats to header and remove download buttons
- Move statistics section from footer to header area
- Position stats below language toggle buttons
- Remove View on GitHub and download buttons from header
- Add elegant glass-morphism styling for header stats
- Improve mobile responsiveness for header stats
- Clean up footer layout
2025-07-09 17:00:08 +08:00
P小二
48fcaec97d fix: resolve language toggle button hover floating issue 2025-07-09 16:52:03 +08:00
14 changed files with 407 additions and 2036 deletions

35
404.md
View File

@@ -1,35 +0,0 @@
---
title: "404 - Page Not Found"
description: "The page you're looking for doesn't exist."
layout: default
permalink: /404.html
---
# 🔍 404 - 页面未找到 / Page Not Found
## 😅 抱歉,您要访问的页面不存在!
### 🏠 您可以:
* [返回首页 / Go Home]({{ '/' | relative_url }}) 🐍
* [查看中文版 / View Chinese Version]({{ '/README_cn.html' | relative_url }}) 🇨🇳
* [访问 GitHub 仓库 / Visit GitHub Repository]({{ site.github.repository_url }}) 📁
### 📚 或者浏览我们的资源:
* **🎓 学习教程** - Python从基础到高级
* **📖 推荐书籍** - 精选Python学习书籍
* **🔧 实用工具** - 开发必备工具
* **🤖 AI/ML资源** - 人工智能和机器学习
### 💡 可能的原因:
* 链接已更新或移动
* 输入了错误的URL
* 页面正在维护中
---
**🚀 FlyPython** - 让Python学习飞起来
如果您认为这是一个错误,请在 [GitHub Issues]({{ site.github.repository_url }}/issues) 中报告。

42
Gemfile
View File

@@ -1,42 +0,0 @@
source "https://rubygems.org"
# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like this:
#
# bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
gem "jekyll", "~> 4.3.2"
# This is the default theme for new Jekyll sites.
gem "jekyll-theme-cayman", "~> 0.2.0"
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
# gem "github-pages", group: :jekyll_plugins
# If you have any plugins, put them here!
group :jekyll_plugins do
gem "jekyll-feed", "~> 0.12"
gem "jekyll-sitemap", "~> 1.4"
gem "jekyll-seo-tag", "~> 2.8"
gem "jekyll-optional-front-matter", "~> 0.3.2"
gem "jekyll-readme-index", "~> 0.3.0"
end
# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
gem "tzinfo", ">= 1", "< 3"
gem "tzinfo-data"
end
# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
# do not have a Java counterpart.
gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]

371
README.md
View File

@@ -1,244 +1,183 @@
---
title: "FlyPython - Python Learning Resources"
description: "A curated collection of Python learning resources including tutorials, books, courses, and best practices for developers at all levels."
layout: default
lang: en
permalink: /
---
# 🐍 FlyPython - LLM Agent & AI Development Hub
# 🐍 FlyPython
[python.flypython.com](https://python.flypython.com)
[python.flypython.com](https://python.flypython.com )
## 🤖 LLM Agent Python - Core Focus
### 🚀 Leading LLM Agent Frameworks
## Python News
#### **OpenAI Agents SDK**
- [OpenAI Agents Python Documentation](https://openai.github.io/openai-agents-python/) - Official OpenAI Agents SDK for building AI agents
- [OpenAI Python Library](https://github.com/openai/openai-python) - Official OpenAI Python library
- [python official](https://www.python.org/)
- [medium](https://medium.com/tag/python)
- reddit
- [python](https://www.reddit.com/r/Python/)
- [learn python](https://www.reddit.com/r/learnpython/)
- [python tips](https://www.reddit.com/r/pythontips/)
- [python coding](https://www.reddit.com/r/pythoncoding)
#### **CrewAI - Multi-Agent Systems**
- [CrewAI Framework](https://github.com/joaomdmoura/crewAI) - Cutting-edge framework for orchestrating role-playing, autonomous AI agents
- [CrewAI Documentation](https://docs.crewai.com/) - Official CrewAI documentation
- [CrewAI Examples](https://github.com/joaomdmoura/crewAI-examples) - Real-world CrewAI implementations
- [Learn Agentic AI with CrewAI](https://github.com/panaversity/learn-agentic-ai) - Comprehensive CrewAI learning resources
#### **LangGraph - Advanced Agent Workflows**
- [LangGraph](https://github.com/langchain-ai/langgraph) - Build stateful, multi-actor applications with LLMs
- [LangChain Agent Framework](https://python.langchain.com/docs/modules/agents/) - LangChain agents and tools
#### **AutoGen - Conversational AI Agents**
- [Microsoft AutoGen](https://github.com/microsoft/autogen) - Multi-agent conversation framework
## Python for LLM
#### **Dapr Agents**
- [Dapr Agents](https://github.com/dapr/python-sdk) - Stateful virtual actors for multi-agent workflows
### 🛠️ Latest Open Source LLM Agent Projects (2024)
#### **Minimal & Educational**
- [min-agent](https://github.com/zhouzaida/min-agent) - Minimal 200-line LLM Agent for understanding agent principles
- [LangChain ReAct Agent](https://github.com/botextractai/ai-langchain-react-agent) - ReAct agent with Python REPL and DuckDuckGo Search
- [OpenSource LLM Agents ReAct](https://github.com/Praveengovianalytics/llm_agents_open_source) - Open source LLM agents implementation
#### **Production-Ready Frameworks**
- [SuperModels](https://github.com/JohannesVC/SuperModels) - Desktop app for running LLM agents with reflection mechanisms
- [AgentKit](https://github.com/japanvik/agentkit) - Simple framework for creating distributed LLM agents over networks
#### **Specialized Applications**
- [CrewAI Platform Examples](https://github.com/genaiworks/crewai) - Multi-agent systems with various real-world applications
- [CrewAI Lenox](https://github.com/samurayy99/crewai_lenox) - Advanced CrewAI implementations
### 📚 LLM Agent Learning Resources
#### **Comprehensive Guides**
- [Building Multi-Agent AI Systems with CrewAI](https://medium.com/neural-engineer/understanding-crewai-building-multi-agent-ai-systems-15d0236d5cbf)
- [Agent Development Best Practices](https://cookbook.openai.com/examples/gpt4-1_prompting_guide)
#### **Courses & Tutorials**
- [Agentic AI Development Course](https://github.com/panaversity/learn-agentic-ai) - Complete course on Dapr Agentic Cloud Ascent (DACA)
- [Python for AI and Machine Learning](https://realpython.com/learning-paths/machine-learning-python/)
- [LangChain Python Documentation](https://python.langchain.com/docs/get_started/introduction/)
- [OpenAI Python Library](https://github.com/openai/openai-python)
- [Building LLM Applications with Python](https://www.deeplearning.ai/short-courses/)
- [LangChain Agent Tutorials](https://python.langchain.com/docs/tutorials/)
## 📖 Python Learning & Development
## Python Books
### 🎯 Quick Navigation
#### Beginner
- 《Python Crash Course: A Hands-On, Project-Based Introduction to Programming for begainners》 (3rd Edition, 2023)
- ※※※※※
- [Amazon](https://www.amazon.com/Python-Crash-Course-Hands-Project-Based/dp/1718502702)
- 《STARTING OUT WITH PYTHON (4TH EDITION)》
- ※※※※※
1. [Python News](#python-news)
2. [Python Books](#python-books)
3. [Courses](#courses)
4. [Algorithms & Data Structures](#algorithms)
5. [Web Development](#web-development)
6. [Data Science & Analysis](#data-science)
7. [Automation & Bots](#automation--bots)
8. [Finance & Trading](#finance--trading)
9. [Performance Optimization](#performance)
---
### Python News
- [Python Official](https://www.python.org/)
- [Medium Python](https://medium.com/tag/python)
- **Reddit Communities:**
- [r/Python](https://www.reddit.com/r/Python/)
- [r/learnpython](https://www.reddit.com/r/learnpython/)
- [r/pythontips](https://www.reddit.com/r/pythontips/)
- [r/pythoncoding](https://www.reddit.com/r/pythoncoding)
### Python Books
#### **For Beginners**
- **Python Crash Course: A Hands-On, Project-Based Introduction to Programming** (3rd Edition, 2023)
- [Amazon](https://www.amazon.com/Python-Crash-Course-Hands-Project-Based/dp/1718502702)
- **Starting Out with Python** (4th Edition)
- [Amazon](https://www.amazon.com/Starting-Out-Python-Tony-Gaddis/dp/0134444329)
- Automate the Boring Stuff with Python: Practical Programming for Total Beginners》 (2nd Edition)
- ※※※※※
- **Automate the Boring Stuff with Python** (2nd Edition)
- [Free Online](https://automatetheboringstuff.com/) | [Amazon](https://www.amazon.com/Automate-Boring-Stuff-Python-Programming/dp/1593279922)
- Python Cookbook: Recipes for Mastering Python 3
- ※※※※※
- **Python Cookbook: Recipes for Mastering Python 3**
- [Amazon](https://www.amazon.co.uk/Python-Cookbook-David-Beazley/dp/1449340377)
#### Modern Python (2023-2024)
- Effective Python: 90 Specific Ways to Write Better Python (2nd Edition)
- ※※※※※
#### **Advanced Python (2023-2024)**
- **Effective Python: 90 Specific Ways to Write Better Python** (2nd Edition) ⭐⭐⭐⭐⭐
- [Amazon](https://www.amazon.com/Effective-Python-Specific-Software-Development/dp/0134853989)
- Clean Code in Python
- ※※※※※
- **Clean Code in Python** ⭐⭐⭐⭐⭐
- [Amazon](https://www.amazon.com/Clean-Code-Python-maintainable-efficient/dp/1788835832)
### Courses
#### **Beginner Courses**
- [Python for Everybody](https://www.coursera.org/specializations/python)
- [Python 3 Programming](https://www.coursera.org/specializations/python-3-programming)
#### **Advanced Learning**
- [REST APIs with Flask and Python in 2024](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az) - Professional Flask Development
- [Financial Analysis with YFinance](https://kritjunsree.medium.com/the-2024-guide-to-using-yfinance-with-python-for-effective-stock-analysis-668a4a26ee3a) - Modern Python Finance Tools
### Algorithms
- [Interactive Python Coding Interview Challenges](https://github.com/donnemartin/interactive-coding-challenges) - Algorithms and data structures
- [Algorithms: Minimal Examples in Python](https://github.com/keon/algorithms) - Data structures and algorithms
- [Pygorithm: Learn Python Algorithms](http://pygorithm.readthedocs.io/en/latest) - Fun way to learn algorithms
### Web Development
#### **FastAPI**
- [FastAPI Documentation](https://fastapi.tiangolo.com/) - Modern, fast web framework for building APIs
- [FastAPI Best Practices](https://github.com/zhanymkanov/fastapi-best-practices)
#### **Flask**
- [REST APIs with Flask and Python in 2024](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az)
- [Developing RESTful APIs with Python and Flask](https://auth0.com/blog/developing-restful-apis-with-python-and-flask)
- [Flask & Code Quality](https://flake8.pycqa.org/en/latest/user/error-codes.html)
#### **Django**
- [Complete Beginner's Guide to Django - Part 1](https://simpleisbetterthancomplex.com/series/2017/09/04/a-complete-beginners-guide-to-django-part-1.html)
- [Build a REST API with Django](https://scotch.io/tutorials/build-a-rest-api-with-django-a-test-driven-approach-part-1)
### Data Science
#### **NumPy**
- [From Python to Numpy](http://www.labri.fr/perso/nrougier/from-python-to-numpy/)
- [Exploring Line Lengths in Python Packages](http://jakevdp.github.io/blog/2017/11/09/exploring-line-lengths-in-python-packages)
#### **Matplotlib**
- [Anatomy of Matplotlib](https://github.com/matplotlib/AnatomyOfMatplotlib)
#### **Data Analysis Projects**
- [Exploring United States Policing Data](https://blog.patricktriest.com/police-data-python)
- [Analyzing 1000+ Greek Wines](https://tselai.com/greek-wines-analysis.html)
- [Generate FiveThirtyEight Graphs](https://www.dataquest.io/blog/making-538-plots)
- [Amazon Product Review Analysis](http://minimaxir.com/2017/01/amazon-spark)
### Automation & Bots
#### **Web Scraping**
- [Web Scraping with Scrapy, SQL, Matplotlib](http://www.scrapingauthority.com/python-scrapy-mysql-and-matplotlib-to-gain-web-data-insights)
- [Advanced Web Scraping: Bypassing 403 Forbidden](http://sangaline.com/post/advanced-web-scraping-tutorial)
- [Mastering Python Web Scraping](https://hackernoon.com/mastering-python-web-scraping-get-your-data-back-e9a5cc653d88)
#### **Automation Projects**
- [Wedding Automation with Twilio and Python](https://www.twilio.com/blog/2017/04/wedding-at-scale-how-i-used-twilio-python-and-google-to-automate-my-wedding.html)
- [Finding Interesting People on Medium](https://medium.freecodecamp.org/how-i-used-python-to-find-interesting-people-on-medium-be9261b924b0)
#### **Bots**
- [Reddit + Facebook Messenger Bot](https://pythontips.com/2017/04/13/making-a-reddit-facebook-messenger-bot)
- [Instagram Bot Success Story](https://medium.freecodecamp.com/my-open-source-instagram-bot-got-me-2-500-real-followers-for-5-in-server-costs-e40491358340)
#### **Spreadsheets Integration**
- [Python Excel Tutorial: The Definitive Guide](https://hackernoon.com/python-excel-tutorial-the-definitive-guide-934ee6dd15b0)
- [Data Analysis with Python in Excel](https://learning.anaconda.cloud/anaconda-certified-data-analysis-with-python-in-excel)
- [Google Sheets and Python](https://www.youtube.com/watch?v=vISRn5qFrkM)
### Finance & Trading
- [2024 Guide to YFinance for Stock Analysis](https://kritjunsree.medium.com/the-2024-guide-to-using-yfinance-with-python-for-effective-stock-analysis-668a4a26ee3a)
- [Quantitative Trading with Python](https://medium.com/@deepml1818/quantitative-trading-with-python-analyzing-financial-data-7c829d447e0a)
- [Financial Data with Alpha Vantage 2024](https://medium.com/@datavisiondallas/navigating-financial-data-with-python-and-alpha-vantage-in-2024-a-beginners-guide-ca005bb1a6c2)
- [Stock Price Data - Python for Finance](https://www.youtube.com/watch?v=2BrpKpWwT2A)
- [Analyzing Cryptocurrency Markets](https://blog.patricktriest.com/analyzing-cryptocurrencies-python)
## Course
#### Beginer
- [Python for Everybody](https://www.coursera.org/specializations/python)
- [Python 3 Programming](https://www.coursera.org/specializations/python-3-programming)
## Data Science
#### matplotlib
- [AnatomyOfMatplotlib](https://github.com/matplotlib/AnatomyOfMatplotlib)
## Github Top 45
<br>
1. [Algorithm](#algorithm)
1. [Guide](#guide)
1. [Structure](#structure)
1. [List](#list)
1. [Class](#class)
1. [Web Scraping](#web-scraping)
1. [Automation](#automation)
1. [Bot](#bot)
1. [Spreasheet](#spreasheet)
1. [Finance](#finance)
1. [Blockchain](#blockchain)
1. [Video Sythesizer](#video-sythesizer)
1. [Performance](#performance)
1. [Django](#django)
1. [Flake](#flake)
1. [NumPy](#numpy)
1. [NashPy](#nashpy)
1. [Markov Process](#markov-process)
1. [Data Analysis](#data-analysis)
1. [Get Started](#get-started)
<br>
### Recommended Learning
A) REST APIs: [REST APIs with Flask and Python in 2024 - Complete Course](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az) [Professional Flask Development with Modern Tools]
B) Financial Analysis: [The 2024 Guide to Using YFinance with Python for Stock Analysis](https://kritjunsree.medium.com/the-2024-guide-to-using-yfinance-with-python-for-effective-stock-analysis-668a4a26ee3a) [Modern Python Finance Tools]
<br>
### Algorithm
* [Interactive Python coding interview challenges (algorithms and data structures)](https://github.com/donnemartin/interactive-coding-challenges?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Algorithms: Minimal examples of data structures and algorithms in Python](https://github.com/keon/algorithms?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Pygorithm: A fun way to learn all major Python algorithms](http://pygorithm.readthedocs.io/en/latest?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Guide
* [wtfPython: A collection of interesting, subtle, and tricky Python snippets](https://github.com/satwikkansal/wtfPython?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Structure
* [Python Packaging User Guide: Creating a Project](https://packaging.python.org/en/latest/tutorials/packaging-projects/)
* [Real Python: Python Modules and Packages](https://realpython.com/python-modules-packages/)
<br>
### List
* [Python List Comprehension Tutorial](https://realpython.com/list-comprehension-python/)
* [Beginner's Guide To List Comprehensions In Python](https://zerotomastery.io/blog/list-comprehension-python/)
<br>
### Class
* [Enriching Your Python Classes With Dunder (Magic, Special) Methods](https://dbader.org/blog/python-dunder-methods?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Web Scraping
* [Web Scraping With Python: Scrapy, SQL, Matplotlib To Gain Web Data Insights](http://www.scrapingauthority.com/python-scrapy-mysql-and-matplotlib-to-gain-web-data-insights?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Advanced Web Scraping: Bypassing "403 Forbidden," captchas, and more](http://sangaline.com/post/advanced-web-scraping-tutorial?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Mastering Python Web Scraping: Get Your Data Back](https://hackernoon.com/mastering-python-web-scraping-get-your-data-back-e9a5cc653d88?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Automation
* [Wedding at Scale: How I Used Twilio, Python and Google to Automate My Wedding](https://www.twilio.com/blog/2017/04/wedding-at-scale-how-i-used-twilio-python-and-google-to-automate-my-wedding.html?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [How I used Python to find interesting people to follow on Medium](https://medium.freecodecamp.org/how-i-used-python-to-find-interesting-people-on-medium-be9261b924b0?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Bot
* [Making a Reddit + Facebook Messenger Bot](https://pythontips.com/2017/04/13/making-a-reddit-facebook-messenger-bot?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [My open source Instagram bot (written in Python) got me 2,500 real followers for $5 in server costs](https://medium.freecodecamp.com/my-open-source-instagram-bot-got-me-2-500-real-followers-for-5-in-server-costs-e40491358340?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Spreadsheet
* [Python Excel Tutorial: The Definitive Guide](https://hackernoon.com/python-excel-tutorial-the-definitive-guide-934ee6dd15b0)
* [Data Analysis with Python in Excel](https://learning.anaconda.cloud/anaconda-certified-data-analysis-with-python-in-excel)
* [Google Sheets and Python](https://www.youtube.com/watch?v=vISRn5qFrkM?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Finance
* [The 2024 Guide to Using YFinance with Python for Stock Analysis](https://kritjunsree.medium.com/the-2024-guide-to-using-yfinance-with-python-for-effective-stock-analysis-668a4a26ee3a)
* [Quantitative Trading with Python: Analyzing Financial Data](https://medium.com/@deepml1818/quantitative-trading-with-python-analyzing-financial-data-7c829d447e0a)
* [Navigating Financial Data with Python and Alpha Vantage in 2024](https://medium.com/@datavisiondallas/navigating-financial-data-with-python-and-alpha-vantage-in-2024-a-beginners-guide-ca005bb1a6c2)
* [Intro and Getting Stock Price Data - Python Programming for Finance p.1 - Sentdex](https://www.youtube.com/watch?v=2BrpKpWwT2A?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Analyzing Cryptocurrency Markets Using Python](https://blog.patricktriest.com/analyzing-cryptocurrencies-python?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Blockchain
* [Learn Blockchains by Building One](https://hackernoon.com/learn-blockchains-by-building-one-117428612f46?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Lets Build the Tiniest Blockchain](https://medium.com/crypto-currently/lets-build-the-tiniest-blockchain-e70965a248b?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Video Synthesizer
* [Building a Video Synthesizer in Python](https://www.makeartwithpython.com/blog/video-synthesizer-in-python?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Performance
* [A million requests per second with Python](https://medium.freecodecamp.com/million-requests-per-second-with-python-95c137af319?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Yes, Python is Slow, and I Dont Care](https://hackernoon.com/yes-python-is-slow-and-i-dont-care-13763980b5a1?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Memoization in Python: How to Cache Function Results Dan Bader](https://dbader.org/blog/python-memoization?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Django
* [A Complete Beginner's Guide to Django - Part 1](https://simpleisbetterthancomplex.com/series/2017/09/04/a-complete-beginners-guide-to-django-part-1.html?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Build a REST API with Django A Test Driven Approach: Part 1](https://scotch.io/tutorials/build-a-rest-api-with-django-a-test-driven-approach-part-1?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Flask & Code Quality
* [Flake8 Error Codes Documentation](https://flake8.pycqa.org/en/latest/user/error-codes.html)
* [REST APIs with Flask and Python in 2024](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az)
* [Developing RESTful APIs with Python and Flask](https://auth0.com/blog/developing-restful-apis-with-python-and-flask?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [REST APIs with Flask and Python - Complete Guide](https://rest-apis-flask.teclado.com/)
<br>
### NumPy
* [From Python to Numpy](http://www.labri.fr/perso/nrougier/from-python-to-numpy/?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Exploring Line Lengths in Python Packages](http://jakevdp.github.io/blog/2017/11/09/exploring-line-lengths-in-python-packages?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### NashPy
* [Nashpy - Tutorial: building and finding the equilibrium for a simple game](http://nashpy.readthedocs.io/en/latest/tutorial?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Markov Process
* [Simulating Chutes & Ladders in Python](https://jakevdp.github.io/blog/2017/12/18/simulating-chutes-and-ladders?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Data Analysis
* [Exploring United States Policing Data Using Python](https://blog.patricktriest.com/police-data-python?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Analyzing 1000+ Greek Wines With Python](https://tselai.com/greek-wines-analysis.html?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [How to Generate FiveThirtyEight Graphs in Python](https://www.dataquest.io/blog/making-538-plots?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Playing with 80 Million Amazon Product Review Ratings Using Apache Spark with Python](http://minimaxir.com/2017/01/amazon-spark?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Fast GeoSpatial Analysis in Python](https://matthewrocklin.com/blog//work/2017/09/21/accelerating-geopandas-1?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [Planet: Understanding the Amazon from Space, 1st Place Winner's Interview](http://blog.kaggle.com/2017/10/17/planet-understanding-the-amazon-from-space-1st-place-winners-interview?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
<br>
### Get Started
* [Learning Python: From Zero to Hero](https://medium.freecodecamp.org/learning-python-from-zero-to-hero-120ea540b567?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [A List of Non Trivial Python Exercises](https://www.ynonperek.com/2017/09/21/python-exercises?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [API Design: Think First, Code Later](https://www.ckl.io/blog/api-design-think-first-code-later?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [The Hitchhikers Guide to Machine Learning in Python](https://medium.freecodecamp.org/the-hitchhikers-guide-to-machine-learning-algorithms-in-python-bfad66adb378?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [How to learn Python programming: 6 experienced Python developers share their learning tips](https://coolpythoncodes.com/best-way-learn-python-programming?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
* [ you can find out How Did Python Become A Data Science Powerhouse?](https://www.youtube.com/watch?v=9by46AAqz70?utm_source=mybridge&utm_medium=email&utm_campaign=read_more)
- [Million Requests per Second with Python](https://medium.freecodecamp.com/million-requests-per-second-with-python-95c137af319)
- [Yes, Python is Slow, and I Don't Care](https://hackernoon.com/yes-python-is-slow-and-i-dont-care-13763980b5a1)
- [Memoization in Python](https://dbader.org/blog/python-memoization)

File diff suppressed because it is too large Load Diff

View File

@@ -1,9 +1,10 @@
# Site settings
title: FlyPython
subtitle: Python 学习资源聚合
subtitle: Python Learning Resource Hub
description: >-
FlyPython 是一个精心策划的 Python 学习资源集合,包含教程、书籍、课程、
工具和最佳实践,帮助从初学者到高级开发者的 Python 学习之旅。
FlyPython is a carefully curated collection of Python learning resources,
including tutorials, books, courses, tools, and best practices to support
Python learners from beginners to advanced developers.
# Site information
url: "https://python.flypython.com"
@@ -11,7 +12,7 @@ baseurl: ""
# Author information
author:
name: FlyPython Community
name: FlyPython
email: hello@flypython.com
github: flypython
twitter: flypython
@@ -34,7 +35,7 @@ plugins:
- jekyll-relative-links
# SEO settings
lang: zh-CN
lang: en
logo: /assets/images/logo.png
# Social links
@@ -62,12 +63,28 @@ defaults:
type: "posts"
values:
layout: "post"
author: "FlyPython Community"
author: "FlyPython"
- scope:
path: ""
type: "pages"
values:
layout: "page"
- scope:
path: "README.md"
values:
layout: "default"
title: "FlyPython - Python Learning Resources"
description: "A curated collection of Python learning resources including tutorials, books, courses, and best practices for developers at all levels."
lang: "en"
permalink: "/"
- scope:
path: "README_cn.md"
values:
layout: "default"
title: "FlyPython - Python 学习资源"
description: "精心策划的 Python 学习资源集合,包含教程、书籍、课程和各级别开发者的最佳实践。"
lang: "zh-CN"
permalink: "/README_cn.html"
- scope:
path: ""
type: "tutorials"
@@ -83,8 +100,8 @@ defaults:
google_analytics: # UA-XXXXXXXX-X
# Features
show_downloads: true
show_github_ribbon: true
show_downloads: false
show_github_ribbon: false
# Custom variables
github:

View File

@@ -1,42 +1,42 @@
main:
- title: "🏠 首页 / Home"
- title: "🏠 Home"
url: "/"
- title: "🇨🇳 中文版"
url: "/README_cn.html"
- title: "📚 资源库 / Resources"
- title: "📚 Resources"
url: "#resources"
children:
- title: "📖 教程 / Tutorials"
- title: "📖 Tutorials"
url: "#tutorials"
- title: "📚 书籍 / Books"
- title: "📚 Books"
url: "#books"
- title: "🎓 课程 / Courses"
- title: "🎓 Courses"
url: "#courses"
- title: "🛠️ 工具 / Tools"
- title: "🛠️ Tools"
url: "#tools"
- title: "🤖 AI/ML"
url: "#ai-ml"
children:
- title: "🧠 LLM"
url: "#python-for-llm"
- title: "📊 数据科学 / Data Science"
- title: "📊 Data Science"
url: "#data-science"
- title: "💹 金融 / Finance"
- title: "💹 Finance"
url: "#finance"
- title: "🔗 GitHub"
url: "https://github.com/flypython/python"
external: true
footer:
- title: "快速链接 / Quick Links"
- title: "Quick Links"
children:
- title: "Python 官网 / Python.org"
- title: "Python.org"
url: "https://python.org"
- title: "PyPI"
url: "https://pypi.org"
- title: "Real Python"
url: "https://realpython.com"
- title: "社区 / Community"
- title: "Community"
children:
- title: "Reddit r/Python"
url: "https://reddit.com/r/Python"

View File

@@ -1,33 +1,6 @@
<!-- Custom CSS -->
<link rel="stylesheet" href="{{ '/assets/css/custom.css' | relative_url }}">
<style>
/* Language Toggle Styles */
.language-toggle {
margin: 1rem 0;
}
.btn-lang {
display: inline-block;
margin: 0 0.25rem;
padding: 0.5rem 1rem;
background-color: rgba(255, 255, 255, 0.2);
color: white;
text-decoration: none;
border-radius: 0.3rem;
border: 1px solid rgba(255, 255, 255, 0.3);
transition: all 0.2s ease;
}
.btn-lang:hover {
background-color: rgba(255, 255, 255, 0.3);
border-color: rgba(255, 255, 255, 0.5);
}
.btn-lang.active {
background-color: rgba(255, 255, 255, 0.9);
color: #333;
border-color: rgba(255, 255, 255, 0.9);
}
/* Table of Contents Styles */
.toc {
@@ -235,7 +208,7 @@
<link rel="icon" type="image/x-icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>🐍</text></svg>">
<!-- Additional Meta Tags -->
<meta name="keywords" content="Python, 教程, 学习, 编程, 资源, tutorials, learning, programming, resources">
<meta name="keywords" content="Python, tutorials, learning, programming, resources, books, courses, guides, development">
<meta name="robots" content="index, follow">
<meta property="og:type" content="website">
<meta property="og:image" content="{{ site.url }}/assets/images/og-image.png">

View File

@@ -27,20 +27,23 @@
<a href="{{ '/README_cn.html' | relative_url }}" class="btn-lang {% if page.url contains 'README_cn' %}active{% endif %}">🇨🇳 中文</a>
</div>
{% if site.github.is_project_page %}
<a href="{{ site.github.repository_url }}" class="btn">View on GitHub</a>
{% endif %}
{% if site.show_downloads %}
<a href="{{ site.github.zip_url }}" class="btn">Download .zip</a>
<a href="{{ site.github.tar_url }}" class="btn">Download .tar.gz</a>
{% endif %}
<!-- Header Stats -->
<div class="header-stats">
<p>📊 Last updated: {{ site.time | date: "%Y-%m-%d" }} |
🔗 Total Resources: 100+ |
⭐ GitHub Stars:
<a href="{{ site.github.repository_url }}/stargazers">
<img src="https://img.shields.io/github/stars/{{ site.github.repository_nwo }}?style=social" alt="GitHub stars">
</a>
</p>
</div>
</header>
<main id="content" class="main-content" role="main">
<!-- Table of Contents for long pages -->
{% if content contains '##' %}
<nav class="toc">
<h3>📚 目录 / Table of Contents</h3>
<h3>📚 Table of Contents</h3>
<div id="toc-content"></div>
</nav>
{% endif %}
@@ -58,15 +61,7 @@
Powered by <a href="https://pages.github.com">GitHub Pages</a> and
<a href="https://jekyllrb.com">Jekyll</a> with ❤️
</span>
<div class="footer-stats">
<p>📊 Last updated: {{ site.time | date: "%Y-%m-%d" }} |
🔗 Total Resources: 100+ |
⭐ GitHub Stars:
<a href="{{ site.github.repository_url }}/stargazers">
<img src="https://img.shields.io/github/stars/{{ site.github.repository_nwo }}?style=social" alt="GitHub stars">
</a>
</p>
</div>
</footer>
</main>

View File

@@ -22,6 +22,9 @@ body {
border-radius: 0.3rem;
border: 1px solid rgba(255, 255, 255, 0.3);
transition: all 0.2s ease;
/* Ensure buttons are not affected by generic .btn styles */
transform: none !important;
box-shadow: none;
}
.btn-lang:hover {
@@ -29,12 +32,50 @@ body {
border-color: rgba(255, 255, 255, 0.5);
text-decoration: none;
color: white;
/* Disable transform effects on hover */
transform: none !important;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}
.btn-lang.active {
background-color: rgba(255, 255, 255, 0.9);
color: #333;
border-color: rgba(255, 255, 255, 0.9);
transform: none !important;
}
/* Header Stats */
.header-stats {
margin-top: 1rem;
padding: 0.75rem 1rem;
background: rgba(255, 255, 255, 0.1);
border-radius: 0.5rem;
backdrop-filter: blur(10px);
border: 1px solid rgba(255, 255, 255, 0.2);
}
.header-stats p {
margin: 0;
color: rgba(255, 255, 255, 0.9);
font-size: 0.9rem;
text-align: center;
font-weight: 300;
}
.header-stats a {
color: rgba(255, 255, 255, 0.95);
text-decoration: none;
transition: all 0.2s ease;
}
.header-stats a:hover {
color: white;
text-decoration: none;
}
.header-stats img {
vertical-align: middle;
margin-left: 0.25rem;
}
/* Enhanced Header */
@@ -54,12 +95,12 @@ body {
opacity: 0.9;
}
/* Enhanced Buttons */
.btn {
/* Enhanced Buttons - Only affects GitHub buttons, not language toggle buttons */
.btn:not(.btn-lang) {
transition: all 0.3s ease;
}
.btn:hover {
.btn:not(.btn-lang):hover {
transform: translateY(-2px);
box-shadow: 0 4px 8px rgba(0,0,0,0.2);
}
@@ -319,6 +360,16 @@ body {
max-width: 200px;
}
.header-stats {
margin: 1rem 0;
padding: 0.5rem;
}
.header-stats p {
font-size: 0.8rem;
line-height: 1.4;
}
.toc {
margin: 1rem 0;
padding: 1rem;

View File

@@ -1,118 +0,0 @@
# FlyPython 内容更新总结报告
## 📅 更新日期
2024年12月
## ✅ 已修复的失效链接
### 🔴 高优先级修复21个失效链接
#### DataCamp 链接替代
-`http://www.datacamp.com/community/tutorials/python-list-comprehension`
- ✅ 替换为:
- [Python List Comprehension Tutorial - Real Python](https://realpython.com/list-comprehension-python/)
- [Beginner's Guide To List Comprehensions - Zero to Mastery](https://zerotomastery.io/blog/list-comprehension-python/)
-`http://www.datacamp.com/community/tutorials/python-excel-tutorial`
- ✅ 替换为:
- [Python Excel Tutorial: The Definitive Guide - HackerNoon](https://hackernoon.com/python-excel-tutorial-the-definitive-guide-934ee6dd15b0)
- [Data Analysis with Python in Excel - Anaconda](https://learning.anaconda.cloud/anaconda-certified-data-analysis-with-python-in-excel)
-`https://www.datacamp.com/community/tutorials/finance-python-trading`
- ✅ 替换为:
- [The 2024 Guide to Using YFinance with Python](https://kritjunsree.medium.com/the-2024-guide-to-using-yfinance-with-python-for-effective-stock-analysis-668a4a26ee3a)
- [Quantitative Trading with Python: Analyzing Financial Data](https://medium.com/@deepml1818/quantitative-trading-with-python-analyzing-financial-data-7c829d447e0a)
#### Udemy/Bit.ly 短链接替代
-`http://bit.ly/2nktytU` (REST API课程)
-`http://bit.ly/2FfVW8G` (算法交易课程)
-`https://www.udemy.com/rest-api-flask-and-python/`
-`https://www.udemy.com/python-for-finance-and-trading-algorithms/`
- ✅ 替换为:
- [REST APIs with Flask and Python in 2024 - Coursera](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az)
- [REST APIs with Flask and Python - Complete Guide](https://rest-apis-flask.teclado.com/)
#### 个人博客/失效网站替代
-`http://veekaybee.github.io/2017/09/26/python-packaging`
- ✅ 替换为:
- [Python Packaging User Guide](https://packaging.python.org/en/latest/tutorials/packaging-projects/)
- [Real Python: Python Modules and Packages](https://realpython.com/python-modules-packages/)
-`https://lintlyci.github.io/Flake8Rules`
- ✅ 替换为:
- [Flake8 Error Codes Documentation](https://flake8.pycqa.org/en/latest/user/error-codes.html)
#### Reddit链接说明
-**保留** Reddit链接 (虽然检测为403但实际可访问只是阻止自动化检查)
## 🆕 新增现代化内容
### Python for LLM 部分(全新添加)
- [Python for AI and Machine Learning](https://realpython.com/learning-paths/machine-learning-python/)
- [LangChain Python Documentation](https://python.langchain.com/docs/get_started/introduction/)
- [OpenAI Python Library](https://github.com/openai/openai-python)
- [Building LLM Applications with Python](https://www.deeplearning.ai/short-courses/)
### 现代Python书籍推荐
#### 英文版新增:
- **Modern Python (2023-2024)** 新分类
- 《Effective Python: 90 Specific Ways to Write Better Python》 (2nd Edition)
- 《Clean Code in Python》
- 更新了经典书籍到最新版本
#### 中文版新增:
- **现代Python2023-2024** 新分类
- 《Python数据科学手册》第2版
- 《Python机器学习实战》
- 《深度学习入门基于Python的理论与实现》
- 《Python高性能编程》
- 《架构整洁之道Python编程》
### 课程资源扩充
#### 中文课程新增:
- **进阶课程** 分类
- **专业领域** 分类
- 中文本土化资源菜鸟教程、廖雪峰Python教程
### 分类结构优化
- **Spreasheet** → **Spreadsheet** (修正拼写错误)
- **Flake** → **Flask & Code Quality** (更准确的分类)
- 添加了更多Flask REST API开发资源
## 📈 内容质量提升
### 🎯 2024年现代化
- 所有新增资源都是2023-2024年的最新内容
- 替代了过时的2017-2018年资源
- 添加了现代Python生态工具和最佳实践
### 🌏 本土化改善
- 为中文用户添加了更多中文资源
- 保持了英文资源的国际化视野
- 提供了免费和付费资源的平衡
### 🔧 技术栈现代化
- 从过时的Udemy课程转向现代平台Coursera、官方文档
- 添加了容器化、CI/CD等现代开发实践
- 包含了AI/ML/LLM等前沿技术
## 📊 统计数据
- **修复失效链接**: 21个
- **新增链接**: 25个
- **更新资源**: 15个
- **新增分类**: 4个
- **提升覆盖面**: AI/ML、数据科学、Web开发、金融科技
## 🔄 后续维护建议
1. **季度链接检查**: 使用 `tools/check_links.py` 脚本定期验证
2. **年度内容审核**: 每年更新书籍推荐和课程资源
3. **社区反馈收集**: 建立用户反馈机制
4. **技术趋势跟踪**: 关注Python生态新发展
---
**更新完成时间**: 2024年12月
**更新人员**: AI Assistant
**下次检查建议**: 2025年3月

View File

@@ -1,145 +0,0 @@
---
title: "Contributing to FlyPython"
description: "How to contribute to the FlyPython project"
---
# 🤝 Contributing to FlyPython
感谢您对 FlyPython 项目的关注!我们欢迎各种形式的贡献。
## 📋 贡献方式 / Ways to Contribute
### 🔗 资源推荐 / Resource Recommendations
- 推荐优质的Python学习资源
- 分享有用的工具和库
- 提供最新的教程和课程信息
### 🐛 问题报告 / Issue Reporting
- 报告失效的链接
- 指出内容错误或过时信息
- 建议改进网站功能
### 📝 内容改进 / Content Improvement
- 改进文档质量
- 添加描述和分类
- 翻译内容(中英文)
### 💻 技术贡献 / Technical Contributions
- 改进网站设计
- 优化性能
- 添加新功能
## 🔄 贡献流程 / Contribution Process
### 1. Fork 项目
```bash
# 克隆你的 fork
git clone https://github.com/YOUR-USERNAME/python.git
cd python
```
### 2. 创建分支
```bash
# 创建新分支用于你的更改
git checkout -b feature/your-feature-name
# 或者
git checkout -b fix/issue-description
```
### 3. 进行更改
- 遵循现有的格式和风格
- 确保链接有效
- 添加适当的描述
### 4. 测试更改
```bash
# 本地测试 Jekyll 网站
bundle install
bundle exec jekyll serve
# 检查链接有效性
python tools/check_links.py
```
### 5. 提交更改
```bash
git add .
git commit -m "feat: add new Python tutorial resource"
# 或者
git commit -m "fix: update broken link in finance section"
```
### 6. 推送并创建 Pull Request
```bash
git push origin your-branch-name
```
然后在 GitHub 上创建 Pull Request。
## 📝 提交信息规范 / Commit Message Convention
使用语义化提交信息:
- `feat:` 添加新功能或资源
- `fix:` 修复问题或错误
- `docs:` 更新文档
- `style:` 格式化或样式更改
- `refactor:` 重构代码
- `test:` 添加或修改测试
- `chore:` 维护任务
### 示例 / Examples:
```
feat: add new machine learning tutorial section
fix: update broken DataCamp links
docs: improve installation instructions
style: format README according to style guide
```
## 📚 内容质量标准 / Content Quality Standards
### 资源推荐标准
1. **相关性**: 必须与Python学习相关
2. **质量**: 内容准确、实用、最新
3. **可访问性**: 链接有效,内容可访问
4. **多样性**: 涵盖不同难度级别和应用领域
### 链接要求
- 提供工作的URL
- 添加描述说明
- 注明语言(中文/英文)
- 标注难度级别(如适用)
### 格式要求
- 使用Markdown格式
- 遵循现有的结构和风格
- 添加适当的emoji和分类标签
## 🔍 代码审查 / Code Review
所有贡献都将经过代码审查:
1. **内容审查**: 确保资源质量和相关性
2. **格式检查**: 验证Markdown格式和链接
3. **技术审查**: 检查代码质量和性能
4. **兼容性测试**: 确保与GitHub Pages兼容
## 🆘 获取帮助 / Getting Help
如果您有任何问题:
1. 查看现有的 [Issues](https://github.com/flypython/python/issues)
2. 创建新的 Issue 描述您的问题
3. 在 Pull Request 中提问
## 📄 许可证 / License
通过贡献到这个项目,您同意您的贡献将在与项目相同的许可证下授权。
## 🙏 致谢 / Acknowledgments
感谢所有贡献者使 FlyPython 成为更好的Python学习资源
---
**🚀 Happy Contributing!** 让我们一起让Python学习变得更好

View File

@@ -1,281 +0,0 @@
---
title: "Deployment Guide"
description: "How to deploy FlyPython website"
---
# 🚀 FlyPython 部署指南 / Deployment Guide
本文档说明如何部署和维护 FlyPython 网站。
## 🏗️ 架构概览 / Architecture Overview
```
FlyPython Website
├── GitHub Repository (Source)
├── GitHub Pages (Hosting)
├── Jekyll (Static Site Generator)
├── Cayman Theme (UI Framework)
└── Custom CSS/JS (Enhancements)
```
## 📁 项目结构 / Project Structure
```
python/
├── _config.yml # Jekyll 配置
├── _layouts/ # 页面布局模板
│ └── default.html
├── _includes/ # 可重用组件
│ └── head-custom.html
├── _data/ # 数据文件
│ └── navigation.yml
├── assets/ # 静态资源
│ └── css/
│ └── custom.css
├── docs/ # 文档目录
├── tools/ # 维护工具
│ └── check_links.py
├── README.md # 英文主页
├── README_cn.md # 中文主页
├── 404.md # 错误页面
├── robots.txt # SEO配置
├── CNAME # 域名配置
└── Gemfile # Ruby依赖
```
## 🌐 GitHub Pages 部署 / GitHub Pages Deployment
### 自动部署 / Automatic Deployment
GitHub Pages 会自动构建和部署:
1. **推送到主分支** → 自动触发构建
2. **Jekyll 处理** → 生成静态文件
3. **部署到 GitHub Pages** → 网站更新
### 部署配置
```yaml
# _config.yml 关键配置
url: "https://python.flypython.com"
baseurl: ""
remote_theme: pages-themes/cayman@v0.2.0
plugins:
- jekyll-feed
- jekyll-sitemap
- jekyll-seo-tag
```
### 域名配置
```
# CNAME 文件内容
python.flypython.com
```
## 🔧 本地开发 / Local Development
### 环境要求
- Ruby 2.7+
- Bundler
- Jekyll
### 安装步骤
```bash
# 1. 克隆仓库
git clone https://github.com/flypython/python.git
cd python
# 2. 安装依赖
bundle install
# 3. 启动本地服务器
bundle exec jekyll serve
# 4. 访问网站
# http://localhost:4000
```
### 开发命令
```bash
# 本地开发服务器
bundle exec jekyll serve --watch --drafts
# 构建静态文件
bundle exec jekyll build
# 检查链接有效性
python tools/check_links.py
# 清理构建文件
bundle exec jekyll clean
```
## 📊 性能监控 / Performance Monitoring
### 构建时间优化
```yaml
# 排除不必要的文件
exclude:
- tools/
- docs/DEPLOYMENT.md
- link_audit_report.md
- content_update_summary.md
```
### 资源优化
- **图片压缩**: 使用WebP格式
- **CSS压缩**: 启用SASS压缩
- **JavaScript最小化**: 使用Jekyll插件
## 🔍 SEO 配置 / SEO Configuration
### 关键配置
```yaml
# SEO设置
title: FlyPython
description: "Python学习资源聚合"
lang: zh-CN
plugins:
- jekyll-seo-tag
- jekyll-sitemap
```
### Sitemap 自动生成
- **sitemap.xml**: 自动生成
- **robots.txt**: 手动配置
- **Meta标签**: 自动添加
## 🛡️ 安全性 / Security
### HTTPS 配置
- GitHub Pages 自动提供 HTTPS
- 强制 HTTPS 重定向已启用
### 依赖管理
```bash
# 更新依赖
bundle update
# 安全审计
bundle audit
```
## 📈 分析和监控 / Analytics & Monitoring
### Google Analytics可选
```yaml
# _config.yml
google_analytics: UA-XXXXXXXX-X
```
### 性能指标
- **页面加载时间**: < 3秒
- **首字节时间**: < 1秒
- **可用性**: 99.9%
## 🔄 CI/CD 流程 / CI/CD Pipeline
### GitHub Actions 工作流
```yaml
# .github/workflows/deploy.yml
name: Deploy to GitHub Pages
on:
push:
branches: [ master ]
jobs:
build-and-deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Setup Ruby
uses: ruby/setup-ruby@v1
with:
ruby-version: 3.0
- name: Install dependencies
run: bundle install
- name: Build site
run: bundle exec jekyll build
- name: Check links
run: python tools/check_links.py
```
## 🚨 故障排除 / Troubleshooting
### 常见问题
1. **构建失败**
```bash
# 检查依赖
bundle install
bundle exec jekyll build --verbose
```
2. **链接失效**
```bash
# 运行链接检查
python tools/check_links.py
```
3. **样式问题**
```bash
# 清理缓存
bundle exec jekyll clean
bundle exec jekyll build
```
### 调试命令
```bash
# 详细构建日志
bundle exec jekyll build --verbose
# 增量构建
bundle exec jekyll build --incremental
# 跟踪模式
bundle exec jekyll build --trace
```
## 📅 维护计划 / Maintenance Schedule
### 定期任务
- **每周**: 检查链接有效性
- **每月**: 更新依赖包
- **每季度**: 内容审核和更新
- **每年**: 重大版本升级
### 更新流程
1. 创建新分支
2. 更新内容
3. 本地测试
4. 提交 Pull Request
5. 代码审查
6. 合并到主分支
7. 自动部署
---
## 📞 支持联系 / Support Contact
如有部署问题
1. 查看 [GitHub Issues](https://github.com/flypython/python/issues)
2. 创建新的 Issue
3. 联系维护团队
**🎯 目标**: 保持网站高可用性和最佳性能

View File

@@ -1,195 +0,0 @@
# FlyPython Jekyll 升级总结报告
## 📅 升级日期
2024年12月
## ✅ 已完成的升级工作
### 🎨 主题和设计升级
#### 1. 现代化主题
- ❌ 旧主题: `jekyll-theme-minimal` (基础主题)
- ✅ 新主题: `pages-themes/cayman@v0.2.0` (现代化主题)
- **改进**: 更美观的头部设计、渐变背景、响应式布局
#### 2. 自定义样式系统
- ✅ 创建 `assets/css/custom.css` (350+ 行自定义样式)
- ✅ 语言切换按钮 (中英文双语支持)
- ✅ 表格式目录 (TOC) 自动生成
- ✅ 回到顶部按钮
- ✅ 增强的链接悬停效果
- ✅ 移动端响应式设计
- ✅ 暗色模式支持
- ✅ 打印样式优化
### ⚙️ 技术架构升级
#### 1. Jekyll 配置优化
```yaml
# 主要改进
title: FlyPython
subtitle: Python 学习资源聚合
remote_theme: pages-themes/cayman@v0.2.0
plugins: [jekyll-feed, jekyll-sitemap, jekyll-seo-tag, ...]
```
#### 2. SEO 优化配置
- ✅ 自动生成 sitemap.xml
- ✅ SEO 标签自动添加
- ✅ 多语言支持 (zh-CN/en-US)
- ✅ Open Graph 标签
- ✅ Twitter Card 支持
- ✅ robots.txt 配置
#### 3. 页面布局系统
-`_layouts/default.html` - 主布局模板
-`_includes/head-custom.html` - 自定义头部
-`_data/navigation.yml` - 导航配置
-`404.md` - 自定义错误页面
### 📁 项目结构优化
#### 新增目录结构
```
python/
├── _layouts/ # 🆕 Jekyll 布局模板
├── _includes/ # 🆕 可重用组件
├── _data/ # 🆕 配置数据
├── assets/ # 🆕 静态资源
│ └── css/custom.css
├── docs/ # 🆕 项目文档
│ ├── CONTRIBUTING.md
│ └── DEPLOYMENT.md
├── tools/ # 🔄 维护工具 (已存在)
├── README.md # 🔄 增强 Front Matter
├── README_cn.md # 🔄 增强 Front Matter
├── 404.md # 🆕 错误页面
├── robots.txt # 🆕 SEO 配置
├── .gitignore # 🆕 Git 忽略规则
└── Gemfile # 🆕 Ruby 依赖管理
```
### 🌟 用户体验提升
#### 1. 导航体验
- **双语切换**: 🇺🇸 English ↔ 🇨🇳 中文
- **智能目录**: 自动生成页面目录导航
- **回到顶部**: 长页面滚动辅助
#### 2. 视觉设计
- **渐变头部**: 美观的蓝绿色渐变
- **卡片式布局**: 现代化的内容展示
- **图标增强**: Emoji 和视觉图标
- **字体优化**: Open Sans 字体系统
#### 3. 移动端优化
- **响应式设计**: 完全适配移动设备
- **触摸友好**: 大按钮和清晰导航
- **快速加载**: 优化资源加载
### 🔧 开发体验改进
#### 1. 本地开发环境
```bash
# 完整的开发环境配置
bundle install
bundle exec jekyll serve
```
#### 2. 维护工具
- ✅ 链接检查工具 (`tools/check_links.py`)
- ✅ 构建脚本配置
- ✅ 依赖管理 (Gemfile)
#### 3. 文档体系
-**贡献指南** (`docs/CONTRIBUTING.md`)
-**部署文档** (`docs/DEPLOYMENT.md`)
-**代码规范** 和提交规范
### 📊 性能优化
#### 1. 加载速度
- **CSS 优化**: 精简自定义样式
- **图片优化**: 支持现代图片格式
- **缓存策略**: 浏览器缓存配置
#### 2. SEO 性能
- **页面标题**: 自动生成优化标题
- **Meta 描述**: 完善的页面描述
- **结构化数据**: Jekyll SEO 插件支持
### 🛡️ 技术稳定性
#### 1. GitHub Pages 兼容性
- ✅ 使用 GitHub Pages 白名单插件
- ✅ 主题版本锁定 (`@v0.2.0`)
- ✅ 依赖版本管理
#### 2. 错误处理
- ✅ 自定义 404 页面
- ✅ 优雅的错误显示
- ✅ 用户友好的错误信息
## 📈 升级效果对比
### 升级前 (旧版本)
- ❌ 基础的 minimal 主题
- ❌ 无自定义样式
- ❌ 无移动端优化
- ❌ 无 SEO 配置
- ❌ 无导航系统
- ❌ 简单的文件结构
### 升级后 (新版本)
- ✅ 现代化 Cayman 主题
- ✅ 350+ 行自定义样式
- ✅ 完全响应式设计
- ✅ 完整 SEO 优化
- ✅ 智能导航和目录
- ✅ 专业项目结构
## 🎯 用户价值提升
### 1. 学习体验
- **更好的可读性**: 优化的字体和行间距
- **便捷的导航**: 自动目录和语言切换
- **移动友好**: 随时随地学习Python
### 2. 内容发现
- **SEO 优化**: 更容易被搜索引擎发现
- **分类清晰**: 良好的信息架构
- **链接有效**: 定期维护和更新
### 3. 社区参与
- **贡献友好**: 详细的贡献指南
- **开发简单**: 完整的本地开发环境
- **维护便捷**: 自动化工具和流程
## 🔮 未来规划
### 即将推出
1. **CI/CD 流程** - 自动化构建和部署
2. **移动端优化** - 进一步提升移动体验
3. **SEO 优化** - 更深度的搜索引擎优化
4. **分析集成** - 用户行为数据收集
### 长期目标
- **多语言支持**: 扩展更多语言版本
- **交互功能**: 搜索、筛选、收藏功能
- **API 接口**: 资源数据API服务
- **社区功能**: 用户评分和评论系统
---
## ✨ 总结
通过这次全面的Jekyll升级FlyPython网站从一个基础的资源列表升级为具有现代化设计、优秀用户体验和专业技术架构的Python学习平台。
**🚀 核心成果:**
- 📈 **用户体验提升 200%**
- 🎨 **视觉设计现代化**
- 📱 **移动端完全适配**
- 🔍 **SEO 优化完善**
- 🛠️ **开发体验极大改善**
**下一步**: 继续优化移动端体验和SEO建立更完善的维护流程

View File

@@ -1,105 +0,0 @@
# FlyPython 链接审核报告
## 📊 总体统计
- **总链接数**: 113个
- **正常链接**: 85个 (75.2%)
- **失效链接**: 21个 (18.6%) 🔴
- **超时链接**: 1个 (0.9%) ⏱️
- **未知状态**: 6个 (5.3%) ❓
## 🔍 问题分析
### 1. Reddit链接问题 (403错误)
**问题**: 所有Reddit链接都返回403错误
**原因**: Reddit对自动化访问有严格限制
**影响链接**:
- https://www.reddit.com/r/Python/
- https://www.reddit.com/r/learnpython/
- https://www.reddit.com/r/pythontips/
- https://www.reddit.com/r/pythoncoding
**修复建议**: 这些链接实际上是可访问的,只是阻止了自动化检查。保留这些链接。
### 2. DataCamp链接问题 (403错误)
**问题**: 所有DataCamp教程链接都返回403错误
**原因**: DataCamp改变了访问策略可能需要登录
**影响链接**:
- Python List Comprehension Tutorial
- Python Excel Tutorial
- Python For Finance: Algorithmic Trading
**修复建议**: 寻找替代的免费教程资源
### 3. Udemy课程链接问题 (403错误)
**问题**: Udemy课程链接返回403错误
**原因**: 可能是地域限制或课程已下架
**影响链接**:
- REST API Flask课程
- Python财务分析课程
**修复建议**: 更新为最新的相关课程链接
### 4. 个人博客/网站失效 (404错误)
**问题**: 一些个人博客和项目网站已不存在
**影响链接**:
- veekaybee.github.io Python打包指南
- tselai.com 希腊葡萄酒分析
- lintlyci.github.io Flake8规则
**修复建议**: 寻找相同主题的替代资源
### 5. 短链接失效
**问题**: bit.ly短链接已失效
**影响链接**:
- bit.ly/2nktytU (REST API课程)
- bit.ly/2FfVW8G (算法交易课程)
**修复建议**: 找到原始链接或更新的课程链接
## 🔧 具体修复建议
### 立即修复 (高优先级)
1. **DataCamp替代资源**:
```markdown
- Python List Comprehension: https://realpython.com/list-comprehension-python/
- Python Excel: https://openpyxl.readthedocs.io/en/stable/tutorial.html
- Python Finance: https://pypi.org/project/yfinance/
```
2. **Udemy课程替代**:
```markdown
- Flask REST API: https://flask-restful.readthedocs.io/en/latest/
- Python Finance: https://github.com/wilsonfreitas/awesome-quant
```
3. **博客文章替代**:
```markdown
- Python Packaging: https://packaging.python.org/tutorials/packaging-projects/
- Flake8 Rules: https://flake8.pycqa.org/en/latest/user/error-codes.html
```
### 中等优先级修复
1. **更新过时内容**: 许多链接指向2017年的文章建议添加更新的资源
2. **添加新兴技术**: 缺少关于现代Python生态的内容如FastAPI、Poetry等
3. **移除UTM参数**: 清理URL中的跟踪参数
### 长期优化建议
1. **定期链接检查**: 建议每季度运行链接检查脚本
2. **链接分类管理**: 按主题重新组织链接结构
3. **本地化内容**: 为中文README添加更多中文资源
4. **现代化更新**: 添加2020年后的新资源和工具
## 📝 下一步行动
1. **立即行动**: 修复21个失效链接
2. **内容审核**: 评估所有2017-2018年的旧内容
3. **新增内容**: 添加Python 3.9+的新特性和工具
4. **结构优化**: 改进README的导航和分类
## 🛠️ 工具推荐
建议将 `check_links.py` 脚本加入到项目维护工具中,定期运行以确保链接质量。