ydx-2147483647 / summaries

各种课程的总结、随记等。

📔Summaries

各种课程的总结、随记等。

🤝改进此项目

✍简单修改

滚动到页面最下方，可直接评论。

若想修改内容，请按以下操作。

1. 单击页面右上角的“编辑此页”📝按钮，进入 GitHub 相应源文件。
2. 单击右上角“Edit this file”🖉按钮，或按E。
3. 按照提示 fork、编辑、提交 pull request。

🤖复杂修改

1. 克隆本仓库。

2. 安装依赖。

   $ just bootstrap

   这会使用python -m pip安装一些包。

   Note

   just是个命令运行器。若无法安装，可手动运行justfile中的命令。

   Note

   若想指定用哪一python，请创建.env文件，写入PYTHON = "/path/to/python"，例如PYTHON = "py -3.11"或PYTHON = "./.venv/Scripts/python.exe"。

3. 编辑。

4. 本地预览。

   $ just serve

   若使用 VS Code，还可以按Ctrl+Shift+B调用任务。

✅导入 Markdown 注意事项

• just normalize +FILES.

• MathJax: \N, \Z, \Q, \R, \C.

  TeX/LaTeX ≠ (canonical) MathJax ≠ Typora. Not all commands are supported.

  Note

  Add the following to window.MathJax.tex.packages in mathjax.js, then undefined control sequences will generate error messages.

  '[-]': ['noundefined']

• Ordered list: 3 spaces → 2-space indent.

• :material-eye-arrow-right:, etc.

• assets

🌟致谢

• Python-Markdown
• MkDocs
• Material for MkDocs
• giscus
• Mdx Truly Sane Lists
• MkDocs RSS plugin
• Graphviz

summaries's Issues

Link Checker Report

Summary

Status	Count
🔍 Total	192
✅ Successful	172
⏳ Timeouts	0
🔀 Redirected	0
👻 Excluded	7
❓ Unknown	0
🚫 Errors	13

Errors per input

Errors in ./docs/course/electromagnetic-field-and-wave.md

• [403] https://math.stackexchange.com/a/2930027/1031068 | Failed: Network error: Forbidden

Errors in ./docs/course/signals-and-systems.md

• [403] https://math.stackexchange.com/a/1115921/1031068 | Failed: Network error: Forbidden

Errors in ./docs/course/information-theory-and-coding.md

• [403] https://dsp.stackexchange.com/a/1169/64418 | Failed: Network error: Forbidden

Errors in ./docs/topic/cov-time.md

• [403] https://math.stackexchange.com/a/2997540/1031068 | Failed: Network error: Forbidden

Errors in ./docs/course/stochastic-signal-processing.md

• [403] https://dsp.stackexchange.com/questions/51877/does-the-auto-correlation-function-of-stationary-random-process-always-converge | Failed: Network error: Forbidden
• [403] https://stats.stackexchange.com/questions/10795/how-to-interpret-an-inverse-covariance-or-precision-matrix | Failed: Network error: Forbidden

Errors in ./docs/course/embedded-systems.md

• [403] https://stackoverflow.com/questions/71746914/ | Failed: Network error: Forbidden

Errors in ./docs/course/probability-and-statistics.md

• [403] https://math.stackexchange.com/a/239199/1031068 | Failed: Network error: Forbidden

Errors in ./docs/course/statistical-digital-signal-processing.md

• [403] https://stats.stackexchange.com/questions/272531/is-a-minimal-sufficient-statistic-also-a-complete-statistic | Failed: Network error: Forbidden
• [403] https://stats.stackexchange.com/questions/187869/ | Failed: Network error: Forbidden
• [403] https://mathoverflow.net/a/182661 | Failed: Network error: Forbidden
• [403] https://stats.stackexchange.com/a/629917/399511 | Failed: Network error: Forbidden
• [403] https://stats.stackexchange.com/questions/166661/basic-intuition-about-minimal-sufficient-statistic | Failed: Network error: Forbidden
  Full Github Actions output

Warnings in CI

https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408

INFO     -  DeprecationWarning: 'version' is deprecated. Use '__version__' instead.
[12](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:13)
  File "/opt/hostedtoolcache/Python/3.11.2/x64/lib/python3.11/site-packages/markdown/__init__.py", line 51, in __getattr__
[13](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:14)
    warnings.warn(
[14](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:15)
  File "/opt/hostedtoolcache/Python/3.11.2/x64/lib/python3.11/site-packages/mdx_truly_sane_lists/__init__.py", line 1, in 
[15](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:16)
    from .mdx_truly_sane_lists import makeExtension
[16](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:17)
WARNING:root:
[17](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:18)
                    [rss-plugin] Running on github actions might lead to wrong                     git revision dates due to a shallow git fetch depth.                     Try setting fetch-depth to 0 in your github action                     (see https://github.com/actions/checkout).
[18](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:19)
                    
[19](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:20)
WARNING:root:
[20](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:21)
                    [rss-plugin] Running on bitbucket pipelines might lead to wrong                     git revision dates due to a shallow git fetch depth.                     Try setting "clone: depth" to "full" in your pipeline                     (see https://support.atlassian.com/bitbucket-cloud/docs/configure-bitbucket-pipelinesyml/
[21](https://github.com/YDX-2147483647/summaries/actions/runs/4346140392/jobs/7591810408#step:7:22)
                    and search 'depth').

• __version__ in mdx_truly_sane_lists.

  False positive. See https://github.com/radude/mdx_truly_sane_lists/blob/0ce5acb09c3ab9cfc268c351417697dc24d26b7c/mdx_truly_sane_lists/mdx_truly_sane_lists.py#L8-L13.

• fetch-depth for rss-plugin.

RSS 图标异常

920d813

Link Checker Report

Summary

Status	Count
🔍 Total	192
✅ Successful	184
⏳ Timeouts	0
🔀 Redirected	0
👻 Excluded	7
❓ Unknown	0
🚫 Errors	1

Errors per input

Errors in ./docs/course/embedded-systems.md

• [ERR] https://www.xiaolincoding.com/network/1_base/tcp_ip_model.html#%E5%BA%94%E7%94%A8%E5%B1%82 | Failed: Network error: error:0A000086:SSL routines:tls_post_process_server_certificate:certificate verify failed:ssl/statem/statem_clnt.c:2092: (certificate has expired)
  Full Github Actions output

日期匹配不了范围

summaries/ReadMe.md

Line 13 in c1d155d

- `> (.*\d+年\d+月\d+日。)` → `> :material-clock-edit-outline: $1`.

> 2022年3月20–21日。

Safari 上访问过 SVG 中链接后会变黑

404 页面不正常

https://ydx-2147483647.github.io/summaries/404

Assets are requested without the repo prefixes. (expect /summaries/assets/*, actual /assets/*)

Notes: squidfunk / mkdocs-material doesn't have this issue.

已提交和未提交的总结

• 202010起
  • 工科数学分析1
  • 🚫学术用途英语1
  • 工程制图
  • ***新时代社会主义**概论
  • **道德修养与法律基础
  • 🚫微信小程序开发
• 202103起
  • 数据结构
  • 🚫物理实验1
  • 线性代数
  • 工科数学分析2
  • 🚫唐宋诗词欣赏
  • **近现代史纲要
  • 物理1
  • 🚫工程训练
• 202108起
  • 复变函数与数理方程
  • 概率论与数理统计
  • 物理2
  • 理论物理导论
  • 电路与模拟电子学
  • 🚫马克思主义基本原理
• 202202起
  • 人工智能导论
  • 信号与系统
  • 半导体物理
  • 数字电路与系统
  • 智能多源感知
  • 电磁场与电磁波
  • 集合论——开启理性思维的钥匙
  • 集成电路设计实践
• 202208起
  • 🚫创意写作
  • 信息论与编码
  • 操作系统原理
  • 轮滑
  • 数字信号处理
  • 数字通信原理
• 附件（已知但未处理）
  • 数字信号处理
    • DFT的间隔与总长.nb
    • data-flow-diagram
  • 半导体物理
    • 绘图.nb
  • 物理、线性代数等的零散文件。

Link Checker Report

Summary

Status	Count
🔍 Total	190
✅ Successful	182
⏳ Timeouts	0
🔀 Redirected	0
👻 Excluded	7
❓ Unknown	0
🚫 Errors	1

Errors per input

Errors in ./docs/course/microwave-circuits.md

• [404] https://web.eecs.utk.edu/~azeumaul/courses/ee531/fall2019/lecturenotes/ECE531-Fall-19-Lecture-07-PN%20Junctions%20Electrostatics.pdf | Failed: Network error: Not Found
  Full Github Actions output

Link Checker Report

Summary

Status	Count
🔍 Total	191
✅ Successful	184
⏳ Timeouts	0
🔀 Redirected	0
👻 Excluded	6
❓ Unknown	0
🚫 Errors	1

Errors per input

Errors in ./docs/course/statistical-digital-signal-processing.md

• [ERR] https://www2.stat.duke.edu/~pdh10/Teaching/721/Materials/ch2blue.pdf | Failed: Network error: error:0A000086:SSL routines:tls_post_process_server_certificate:certificate verify failed:ssl/statem/statem_clnt.c:2092: (unable to get local issuer certificate)
  Full Github Actions output

Redundant RSS `<link>`

MkDocs Material integrates seamlessly with the RSS plugin since v9.2.0 (released in August 2023), and MkDocs RSS Plugin also says everything is automagically set up.

Now we have redundant RSS <link>:

$ xhs https://ydx-2147483647.github.io/summaries/ | rg application/rss
        <link rel="alternate" type="application/rss+xml" title="RSS 订阅" href="feed_rss_created.xml">
        <link rel="alternate" type="application/rss+xml" title="已更新内容的 RSS 订阅" href="feed_rss_updated.xml">
  <link rel="alternate" type="application/rss+xml" title="新增内容的 RSS 源" href="feed_rss_created.xml">
  <link rel="alternate" type="application/rss+xml" title="更新内容的 RSS 源" href="feed_rss_updated.xml">

https://github.com/squidfunk/mkdocs-material/blob/43ed6fac8dfc5385a9bdf22d8bf207c868c23a80/src/templates/base.html#L63-L77

www2.stat.duke.edu 证书链不完整

https://github.com/YDX-2147483647/summaries/actions/runs/6702956864/attempts/1#summary-18212712700

[ERR] https://www2.stat.duke.edu/~pdh10/Teaching/721/Materials/ch2blue.pdf | Failed: Network error: error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed:ssl/statem/statem_clnt.c:1921: (unable to get local issuer certificate)

https://myssl.com/www2.stat.duke.edu?domain=www2.stat.duke.edu&status=success

相似项目

• https://github.com/onlyforqiong/Embedded_principle/

RSS 应只推送标题

• 现在推送的描述是页面开头，并不一定是更新的内容。
• 大部分阅读器不支持 JavaScript，MathJax 无法渲染。
• 难以绕过上述困难。

附加结构

要添加页面之间的关系。可以加在页首或页脚，最好采用对称关系。

Markdown link check 找到了死链

有些是虚警，可能需要按文档忽略。

[✖] ../digital-signal-processing/#Fourier-参数之间的关系 → Status: 400
[✖] ../information-theory-and-coding/#平稳与遍历 → Status: 400
[✖] http://opinion.people.com.cn/n1/2020/0811/c1003-31817420.html → Status: 0
[✖] http://www.cssn.cn/lsx/lishixuezhuanti/bwcxljsm/lxzyls/mzd/201801/t20180104_3803925.shtml → Status: 404
[✖] http://www.qstheory.cn/llqikan/2017-12/03/c_1122049424.htm → Status: 404
[✖] http://www.qstheory.cn/zhuanqu/bkjx/2017-12/01/c_1122044946.htm → Status: 404
[✖] https://isip.bit.edu.cn/jxgz/jxzyxz/b142394.htm → Status: 0
[✖] https://web.eecs.utk.edu/~azeumaul/courses/ee531/fall2019/lecturenotes/ECE531-Fall-19-Lecture-07-PN → Status: 404
[✖] https://www.cs.uic.edu/pub/ECE534/WebHome/ch2.pdf → Status: 500
[✖] https://www.jstor.org/stable/2685037 → Status: 403

真·死链

http://www.cssn.cn/lsx/lishixuezhuanti/bwcxljsm/lxzyls/mzd/201801/t20180104_3803925.shtml
http://www.qstheory.cn/llqikan/2017-12/03/c_1122049424.htm
http://www.qstheory.cn/zhuanqu/bkjx/2017-12/01/c_1122044946.htm

chore: Upgrade to mkdocs-material-9.2

Release mkdocs-material-9.2.0 · squidfunk/mkdocs-material

• Added support for Chinese language segmentaiton in search plugin
• Added support for navigation icons
• …