awesome4girls Ruby架构揭秘RedcarpetNokogiri如何解析Awesome清单【免费下载链接】awesome4girlsA curated list of inclusive events/projects/initiatives for women in the tech area. :gift_heart:项目地址: https://gitcode.com/gh_mirrors/aw/awesome4girlsawesome4girls 是一个面向女性科技从业者的精选清单Awesome List收录全球包容性的活动、项目与倡议。它最巧妙的地方在于用不到 100 行 Ruby 代码通过 Redcarpet 把整份 Markdown 清单渲染成 HTML再用 Nokogiri 以 CSS 选择器精准定位每一个链接与章节最后交给 RSpec 自动校验格式、死链和拼写从机制上保证清单长期保持整洁有序。 先认识一下这是一份什么样的清单awesome4girls 的内容全部沉淀在一份README.md中按主题划分为四大区块描述区项目简介摘要区Table of Contents按语言/主题排好序的目录项目区Events/Meetups、Initiatives/Programs、Jobs 等真正的清单内容License 区CC0 开源协议声明每个条目都遵循统一模板链接 空行 以大写开头、句号结尾的英文描述。️ 架构总览一条「转换 → 提取 → 校验」流水线整个自动化系统只有四个环节层层递进README.md ──▶ RedcarpetMarkdown → HTML ──▶ NokogiriHTML → 链接/章节/描述等结构化数据 ──▶ RSpec断言格式、死链、拼写依赖清单见Gemfileredcarpet、nokogiri、rspec、faradayHTTP 请求、rake、byebug版本锁定在Gemfile.lockNokogiri 1.14.3 / Redcarpet 3.5.1。 Redcarpet把 Markdown 变成可查询的 HTML核心入口在lib/awesome_list.rb的parse类方法中只有三行关键逻辑def self.parse(markdown) renderer Redcarpet::Render::HTML.new raw_html Redcarpet::Markdown.new(renderer).render(markdown) self.new(raw_html) endRedcarpet 把 Markdown 的标题、列表、链接、分隔线统统转成标准 HTML 标签。这一步是后文一切 CSS 选择器查询的基础——先转换、后提取避免手写正则去解析 Markdown 的脆弱写法。 NokogiriCSS 选择器精准定位清单元素AwesomeList类对外暴露了一系列「查询接口」全部基于 Nokogiri 的 CSS 选择器方法选择器作用linksa文档中全部链接summaryul摘要区的目录列表section_titlesh2项目区的一级章节标题subsection_titlesh3二级小节标题如 Clojure、Pythonproject_linksli a每个项目的入口链接剔除锚点跳转其中project_links会用一行link[href].start_with?(#)过滤掉「Go to top」这类站内锚点链接只留下真正指向外部项目的 URL——这个小细节让死链检测不会被自己「误伤」。✂️ 隐藏技巧用hr把文档切成四个独立 DOMREADME 中散落着几条----分隔线Redcarpet 会将其渲染成hr标签。html_sections私有方法据此把整份 HTML「切开」def html_sections(section) Nokogiri::HTML(raw_html.split(hr)[section]) end配合四个常量LIST_DESCRIPTION_SECTION~LICENSE_SECTION项目区、License 区各自成为一棵独立的 HTML 树。这样「章节标题必须按字母排序」这类断言只需要在正确的区块里做不会被目录区、描述区干扰——用分隔线做命名空间是这份清单架构里最聪明的设计。✅ RSpec三道自动质检关卡spec/目录下三个测试文件对应三套质检规则全部在rake默认任务中执行见Rakefile中task :default :spec1️⃣ 格式质检spec/format_spec.rb目录、章节标题、项目链接都必须按字母序排列描述必须大写开头、句号结尾、无尾随空格每个项目必须「链接 描述」成对出现2️⃣ 链接质检spec/links_spec.rb同一 URL 不允许重复出现用 Faraday 真实请求每条链接状态码为 200/301/302 才算通过直接拦截死链3️⃣ 拼写质检spec/misspelling_spec.rb调用 misspell 工具扫描 README 与贡献指南杜绝常见英文拼写错误任何一条不通过CI 都会给出带上下文的具体错误提示并指向CONTRIBUTING.md中的模板规范。 本地跑一遍贡献前的自检流程bundle install # 安装 Gemfile 中的依赖 rake setup rake # 安装拼写检查器然后执行全部规格测试想生成 HTML 预览版清单还有一个内置任务rake gen:html内部正是复用了AwesomeList.parse(File.open(README.md).read)这条解析链路。 小结awesome4girls 的 Ruby 架构证明了「小而美」的自动化思路Redcarpet 负责格式转换、Nokogiri 负责结构化提取、RSpec 负责规则断言。三者各司其职、互不耦合让一份社区维护多年的清单始终格式统一、链接有效、拼写正确。如果你也维护着大型 Markdown 清单这套「转换 → CSS 选择器 → 规格测试」的流水线非常值得借鉴。【免费下载链接】awesome4girlsA curated list of inclusive events/projects/initiatives for women in the tech area. :gift_heart:项目地址: https://gitcode.com/gh_mirrors/aw/awesome4girls创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考