reactjs / reactjs/react.dev

[Suggestion]: Documentation should be printable

未关闭
#7,443 2 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

type: documentation
主要语言
JavaScript
星标
11.8k
派生
7.9k
平均合并
1 天 11 小时
30 天内合并 PR
11

描述

Summary

Currently, the React documentation cannot be printed. Please add features for the documentation to be printable.

Details

I prefer reading documentation offline.

I'd like to add annotations. I want to read documentation from a book, not online.

This way of learning supports nature sustainment, is less energy draining and allows for better concentration.

The React documentation has come to a state where it is stable for the most part.

In the past, I successfully printed loads of online documentation and had some of them even be bound:

my books

Current Situation

Currently, printing the React documentation is not possible:

cannot print React documentation


Desired Situation

  1. Add CSS rules providing for reasonably printing the React documentation

  2. Add a "Download PDF" button to the documentation's left menu for printing a whole chapter/topic spanning several web pages as a whole (e.g. "Describing the UI"), like Microsoft does with their online documentation:

    Image

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

首先查看 React 文档网站的样式和左侧菜单入口,重点了解当前的打印输出和章节导航是如何工作的。完成的标准是文档能够合理打印,并且左侧菜单中的 Download PDF 选项可以生成跨越多个页面的完整章节或主题。

由索引模型根据 Issue 内容生成。

评估

技术栈
css, javascript, react
领域
documentation, frontend
Issue 类型
功能
难度
4/5
预计耗时
3-5 天
活跃度
冷清
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。