diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index fedc097a..2986290c 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -93,6 +93,9 @@ module.exports = config({ ], sidebar: { // 应该把更精确的路径放置在前边 + "/javaguide/": [ + "intro", "contribution-guideline", "faq", "todo" + ], "/about-the-author/": [ { title: "个人经历", icon: "zuozhe", collapsable: false, diff --git a/docs/home.md b/docs/home.md index 96423f66..35fab233 100644 --- a/docs/home.md +++ b/docs/home.md @@ -3,8 +3,6 @@ icon: creative title: JavaGuide(Java学习&&面试指南) --- - -

@@ -24,37 +22,19 @@ title: JavaGuide(Java学习&&面试指南)

-> 1. **贡献指南** :欢迎参与 [JavaGuide 的维护工作](https://zhuanlan.zhihu.com/p/464832264),这是一件非常有意义的事情。 -> 2. **面试专版** :准备面试的小伙伴可以考虑面试专版:[《Java 面试进阶指北 》](https://www.yuque.com/docs/share/f37fc804-bfe6-4b0d-b373-9c462188fec7) (质量很高,专为面试打造,配合 JavaGuide 食用) -> 3. **转载须知** :以下所有文章如非文首说明为转载皆为我(Guide 哥)的原创,转载在文首注明出处,如发现恶意抄袭/搬运,会动用法律武器维护自己的权益。让我们一起维护一个良好的技术创作环境!⛽️ +> 1. **面试专版** :准备面试的小伙伴可以考虑面试专版:[《Java 面试进阶指北 》](https://www.yuque.com/docs/share/f37fc804-bfe6-4b0d-b373-9c462188fec7) (质量很高,专为面试打造,配合 JavaGuide 食用) +> 2. **转载须知** :以下所有文章如非文首说明为转载皆为我(Guide 哥)的原创,转载在文首注明出处,如发现恶意抄袭/搬运,会动用法律武器维护自己的权益。让我们一起维护一个良好的技术创作环境!⛽️ -在大三准备面试的时候,我开源了 JavaGuide 。我把自己准备面试过程中的一些总结都毫不保留地通过 JavaGuide 分享了出来。 +你可能需要: -开源 JavaGuide 初始想法源于自己的个人那一段比较迷茫的学习经历。主要目的是为了通过这个开源平台来帮助一些在学习 Java 或者面试过程中遇到问题的小伙伴。 +- [项目介绍](/javaguide/intro) +- [贡献指南](/javaguide/contribution-guideline) +- [常见问题](/javaguide/faq) +- [项目代办](/javaguide/todo) -- **对于 Java 初学者来说:** 本文档倾向于给你提供一个比较详细的学习路径,让你对于 Java 整体的知识体系有一个初步认识。另外,本文的一些文章也是你学习和复习 Java 知识不错的实践; -- **对于非 Java 初学者来说:** 本文档更适合回顾知识,准备面试,搞清面试应该把重心放在那些问题上。要搞清楚这个道理:提前知道那些面试常见,不是为了背下来应付面试,而是为了让你可以更有针对的学习重点。 +## 面试资源 -相比于其他通过 JavaGuide 学到东西或者说助力获得 offer 的朋友来说 , JavaGuide 对我的意义更加重大。不夸张的说,有时候真的感觉像是自己的孩子一点一点长大一样,我一直用心呵护着它。虽然,我花了很长时间来维护它,但是,我觉得非常值得!非常有意义! - -希望大家对面试不要抱有侥幸的心理,打铁还需自身硬! 我希望这个文档是为你学习 Java 指明方向,而不是用来应付面试用的。加油!奥利给! - -## 项目说明 - -- 项目的 Markdown 格式参考:[Github Markdown 格式](https://guides.github.com/features/mastering-markdown/),表情素材来自:[EMOJI CHEAT SHEET](https://www.webpagefx.com/tools/emoji-cheat-sheet/)。 -- Logo 下的小图标是使用[Shields.IO](https://shields.io/) 生成的。 - -## 贡献者 - -[你可以点此链接查看 JavaGuide 的所有贡献者。](https://github.com/Snailclimb/JavaGuide/graphs/contributors) 感谢你们让 JavaGuide 变得更好!如果你们来到武汉一定要找我,我请你们吃饭玩耍。 - -欢迎参与 [JavaGuide 的维护工作](https://zhuanlan.zhihu.com/p/464832264),这是一件非常有意义的事情。 - -## 待办 - -- [ ] JVM 部分内容更新完善 -- [ ] 计算机网络知识点完善 -- [ ] 分布式常见理论和算法总结完善 + ## 联系我 @@ -70,43 +50,3 @@ title: JavaGuide(Java学习&&面试指南) ![我的公众号](https://cdn.jsdelivr.net/gh/javaguide-tech/blog-images/2020-08/167598cd2e17b8ec.png) -## 常见问题 - -### 如何对该开源文档进行贡献? - -欢迎参与 JavaGuide 的维护工作,这是一件非常有意义的事情。详细信息请看:[JavaGuide 贡献指南](https://zhuanlan.zhihu.com/p/464832264) 。 - -你可以从下面几个方向来做贡献: - -- 笔记内容大多是手敲,所以难免会有笔误,你可以帮我找错别字。 -- 很多知识点我可能没有涉及到,所以你可以对其他知识点进行补充。 -- 现有的知识点难免存在不完善或者错误,所以你可以对已有知识点进行修改/补充。 - -如果要提 issue/question 的话,强烈推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) 和 [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/~sgtatham/bugs-cn.html)、[《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393)。 - -### 如何看待 JavaGuide 的 star 数量很多? - -[JavaGuide](https://github.com/Snailclimb) 目前已经是 Java 领域 star 数量最多的几个项目之一,登顶过很多次 Github Trending。 - -不过,这个真心没啥好嘚瑟的。因为,教程类的含金量其实是比较低的,star 数量比较多主要也是因为受众面比较广,大家觉得不错,点个 star 就相当于收藏了。很多特别优秀的框架,star 数量可能只有几 K。所以,单纯看 star 数量没啥意思,就当看个笑话吧! - -维护这个项目的过程中,也被某些人 diss 过:“md 项目,没啥含金量,给国人丢脸!”。 - -对于说这类话的人,我觉得对我没啥影响,就持续完善,把 JavaGuide 做的更好吧!其实,国外的很多项目也是纯 MD 啊!就比如外国的朋友发起的 awesome 系列、求职面试系列。无需多说,行动自证!凎! - -开源非常重要的一点就是协作。如果你开源了一个项目之后,就不再维护,别人给你提交 issue/pr,你都不处理,那开源也没啥意义了! - -### JavaGuide 会不会推出纸质书籍? - -可以给出一个比较明确的答案:**暂时没有考虑出书** 。 - -JavaGuide 这个项目诞生一年左右就有出版社的老师联系我了,由于自知个人能力尚需沉淀,我都婉拒了。这几年的话,由于项目还是有一点知名度的,找我出书的出版社老师更多了,也都被我一一婉拒了。 - -**出书既能博名又能赚点钱,我为啥不考虑出书呢?** - -1. JavaGuide 的很多内容我还不是很满意,也一直在维护中,细心的小伙伴看我的提交记录就明白了。 -2. 开源版本更容易维护和修改,也能让更多人更方便地参与到项目的建设中,这也是我最初做这个项目的初衷。 -3. 我觉得出书是一件神圣的事情,自认能力还不够。 -4. 个人精力有限,不光有本职工作,还弄了一个[知识星球](https://sourl.cn/psyWaE)赚点外快,还要维护完善 JavaGuide。 - -这几年一直在默默完善,真心希望 JavaGuide 越来越好,帮助到更多朋友!也欢迎大家参与进来! diff --git a/docs/javaguide/contribution-guideline.md b/docs/javaguide/contribution-guideline.md new file mode 100644 index 00000000..fa0b992e --- /dev/null +++ b/docs/javaguide/contribution-guideline.md @@ -0,0 +1,25 @@ +--- +title: 项目贡献指南 +category: 走近项目 +--- + +欢迎参与 JavaGuide 的维护工作,这是一件非常有意义的事情。详细信息请看:[JavaGuide 贡献指南](https://zhuanlan.zhihu.com/p/464832264) 。 + +你可以从下面几个方向来做贡献: + +- 笔记内容大多是手敲,所以难免会有笔误,你可以帮我找错别字。 +- 很多知识点我可能没有涉及到,所以你可以对其他知识点进行补充。 +- 现有的知识点难免存在不完善或者错误,所以你可以对已有知识点进行修改/补充。 + +一定一定一定要注意 **排版规范** : + +- [中文文案排版指北 - Github](https://github.com/sparanoid/chinese-copywriting-guidelines) +- [写给大家看的中文排版指南 - 知乎](https://zhuanlan.zhihu.com/p/20506092) +- [中文文案排版细则 - Dawner](https://dawner.top/posts/chinese-copywriting-rules/) + +如果要提 issue/question 的话,强烈推荐阅读下面这些资料: + +- [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way) +- [《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) +- [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/~sgtatham/bugs-cn.html) +- [《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393)。 \ No newline at end of file diff --git a/docs/javaguide/faq.md b/docs/javaguide/faq.md new file mode 100644 index 00000000..1fecb883 --- /dev/null +++ b/docs/javaguide/faq.md @@ -0,0 +1,32 @@ +--- +title: 常见问题 +category: 走近项目 +--- + + +## 如何看待 JavaGuide 的 star 数量很多? + +[JavaGuide](https://github.com/Snailclimb) 目前已经是 Java 领域 star 数量最多的几个项目之一,登顶过很多次 Github Trending。 + +不过,这个真心没啥好嘚瑟的。因为,教程类的含金量其实是比较低的,star 数量比较多主要也是因为受众面比较广,大家觉得不错,点个 star 就相当于收藏了。很多特别优秀的框架,star 数量可能只有几 K。所以,单纯看 star 数量没啥意思,就当看个笑话吧! + +维护这个项目的过程中,也被某些人 diss 过:“md 项目,没啥含金量,给国人丢脸!”。 + +对于说这类话的人,我觉得对我没啥影响,就持续完善,把 JavaGuide 做的更好吧!其实,国外的很多项目也是纯 MD 啊!就比如外国的朋友发起的 awesome 系列、求职面试系列。无需多说,行动自证!凎! + +开源非常重要的一点就是协作。如果你开源了一个项目之后,就不再维护,别人给你提交 issue/pr,你都不处理,那开源也没啥意义了! + +## JavaGuide 会不会推出纸质书籍? + +可以给出一个比较明确的答案:**暂时没有考虑出书** 。 + +JavaGuide 这个项目诞生一年左右就有出版社的老师联系我了,由于自知个人能力尚需沉淀,我都婉拒了。这几年的话,由于项目还是有一点知名度的,找我出书的出版社老师更多了,也都被我一一婉拒了。 + +**出书既能博名又能赚点钱,我为啥不考虑出书呢?** + +1. JavaGuide 的很多内容我还不是很满意,也一直在维护中,细心的小伙伴看我的提交记录就明白了。 +2. 开源版本更容易维护和修改,也能让更多人更方便地参与到项目的建设中,这也是我最初做这个项目的初衷。 +3. 我觉得出书是一件神圣的事情,自认能力还不够。 +4. 个人精力有限,不光有本职工作,还弄了一个[知识星球](https://sourl.cn/psyWaE)赚点外快,还要维护完善 JavaGuide。 + +这几年一直在默默完善,真心希望 JavaGuide 越来越好,帮助到更多朋友!也欢迎大家参与进来! \ No newline at end of file diff --git a/docs/javaguide/intro.md b/docs/javaguide/intro.md new file mode 100644 index 00000000..e61f407d --- /dev/null +++ b/docs/javaguide/intro.md @@ -0,0 +1,26 @@ +--- +title: 项目介绍 +category: 走近项目 +--- + +在大三准备面试的时候,我开源了 JavaGuide 。我把自己准备面试过程中的一些总结都毫不保留地通过 JavaGuide 分享了出来。 + +开源 JavaGuide 初始想法源于自己的个人那一段比较迷茫的学习经历。主要目的是为了通过这个开源平台来帮助一些在学习 Java 或者面试过程中遇到问题的小伙伴。 + +- **对于 Java 初学者来说:** 本文档倾向于给你提供一个比较详细的学习路径,让你对于 Java 整体的知识体系有一个初步认识。另外,本文的一些文章也是你学习和复习 Java 知识不错的实践; +- **对于非 Java 初学者来说:** 本文档更适合回顾知识,准备面试,搞清面试应该把重心放在那些问题上。要搞清楚这个道理:提前知道那些面试常见,不是为了背下来应付面试,而是为了让你可以更有针对的学习重点。 + +相比于其他通过 JavaGuide 学到东西或者说助力获得 offer 的朋友来说 , JavaGuide 对我的意义更加重大。不夸张的说,有时候真的感觉像是自己的孩子一点一点长大一样,我一直用心呵护着它。虽然,我花了很长时间来维护它,但是,我觉得非常值得!非常有意义! + +希望大家对面试不要抱有侥幸的心理,打铁还需自身硬! 我希望这个文档是为你学习 Java 指明方向,而不是用来应付面试用的。加油!奥利给! + +## 项目说明 + +- 项目的 Markdown 格式参考:[Github Markdown 格式](https://guides.github.com/features/mastering-markdown/),表情素材来自:[EMOJI CHEAT SHEET](https://www.webpagefx.com/tools/emoji-cheat-sheet/)。 +- Logo 下的小图标是使用[Shields.IO](https://shields.io/) 生成的。 + +## 贡献者 + +[你可以点此链接查看 JavaGuide 的所有贡献者。](https://github.com/Snailclimb/JavaGuide/graphs/contributors) 感谢你们让 JavaGuide 变得更好!如果你们来到武汉一定要找我,我请你们吃饭玩耍。 + +欢迎参与 [JavaGuide 的维护工作](https://zhuanlan.zhihu.com/p/464832264),这是一件非常有意义的事情。 \ No newline at end of file diff --git a/docs/javaguide/todo.md b/docs/javaguide/todo.md new file mode 100644 index 00000000..df04b18e --- /dev/null +++ b/docs/javaguide/todo.md @@ -0,0 +1,14 @@ +--- +title: 项目代办 +category: 走近项目 +--- + +- [x] 数据结构内容完善 +- [x] Java 基础内容完善 +- [x] 大篇幅文章拆分 +- [ ] JVM 内容更新完善 +- [ ] 计算机网络知识点完善 +- [ ] 分布式常见理论和算法总结完善 + +欢迎参与 JavaGuide 的维护工作,这是一件非常有意义的事情。详细信息请看:[JavaGuide 贡献指南](./contribution-guideline.md) 。 +