├── .gitignore
├── README.md
├── _config.yml
├── _includes
├── footer.html
├── head.html
├── header.html
└── searchbox.html
├── _layouts
├── default.html
├── indexpage.html
├── page.html
└── post.html
├── _posts
├── c
│ ├── 2004-12-27-acm.markdown
│ ├── 2004-12-28-hacker.markdown
│ ├── 2004-12-29-ugly.markdown
│ ├── 2004-12-30-c-environment.markdown
│ └── 2004-12-31-c.markdown
├── configuration
│ ├── 2003-12-01-terminal-life.markdown
│ ├── 2003-12-24-process-manager.markdown
│ ├── 2003-12-25-utc.markdown
│ ├── 2003-12-26-drives.markdown
│ ├── 2003-12-27-grub.markdown
│ ├── 2003-12-28-video-card.markdown
│ ├── 2003-12-29-desktop-environment.markdown
│ ├── 2003-12-30-qq.markdown
│ ├── 2003-12-31-ime.markdown
│ └── 2003-12-31-install-softwares.markdown
├── development
│ ├── 2007-12-22-docset.markdown
│ ├── 2007-12-23-backend.markdown
│ ├── 2007-12-24-frontend.markdown
│ ├── 2007-12-25-github.markdown
│ ├── 2007-12-26-android-dev.markdown
│ ├── 2007-12-27-gui.markdown
│ ├── 2007-12-28-script.markdown
│ ├── 2007-12-29-ide.markdown
│ ├── 2007-12-30-editor.markdown
│ ├── 2007-12-31-development-software.markdown
│ └── 2007-12-31-vim-and-emacs.markdown
├── entertainment
│ ├── 2006-12-25-twitter-and-facebook-register.markdown
│ ├── 2006-12-27-wine.markdown
│ ├── 2006-12-28-fun-command.markdown
│ ├── 2006-12-30-musicvideo.markdown
│ └── 2006-12-31-game.markdown
├── future
│ └── 2010-12-31-test.markdown
├── mac
│ ├── 2011-12-29-tools.markdown
│ ├── 2011-12-30-port.markdown
│ └── 2011-12-31-mac.markdown
├── network
│ ├── 2008-12-20-g-f-w.markdown
│ ├── 2008-12-21-capture.markdown
│ ├── 2008-12-22-net-commands.markdown
│ ├── 2008-12-23-maintenance.markdown
│ ├── 2008-12-24-wifi.markdown
│ ├── 2008-12-25-cms.markdown
│ ├── 2008-12-26-cloud.markdown
│ ├── 2008-12-27-download.markdown
│ ├── 2008-12-28-network-error.markdown
│ ├── 2008-12-29-ap.markdown
│ ├── 2008-12-30-webserver.markdown
│ └── 2008-12-31-remote.markdown
├── novice
│ ├── 2001-12-25-google.markdown
│ ├── 2001-12-26-edit.markdown
│ ├── 2001-12-27-warning.markdown
│ ├── 2001-12-28-view.markdown
│ ├── 2001-12-29-material.markdown
│ ├── 2001-12-30-how-to-ask.markdown
│ └── 2001-12-31-001.markdown
├── others
│ ├── 2012-12-30-dos-emulator.markdown
│ └── 2012-12-31-genymotion.markdown
├── toy
│ ├── 2009-12-26-temp-monitor-arduino.markdown
│ ├── 2009-12-26-temp-monitor.markdown
│ ├── 2009-12-27-arduino2048.markdown
│ ├── 2009-12-28-gpio.markdown
│ ├── 2009-12-29-other-toys.markdown
│ ├── 2009-12-30-arduino.markdown
│ └── 2009-12-31-raspberry-pi.markdown
├── try
│ ├── 2002-12-27-room.markdown
│ ├── 2002-12-28-terminal.markdown
│ ├── 2002-12-29-vm.markdown
│ ├── 2002-12-30-install-with-win8.markdown
│ ├── 2002-12-31-install.markdown
│ └── 2002-12-31-prepare.markdown
└── work
│ ├── 2005-12-26-flash.markdown
│ ├── 2005-12-27-illustrator.markdown
│ ├── 2005-12-28-photoshop.markdown
│ ├── 2005-12-29-math.markdown
│ ├── 2005-12-30-latex.markdown
│ ├── 2005-12-31-office.markdown
│ └── 2005-12-31software.markdown
├── _sass
├── _back-to-top.scss
├── _base.scss
├── _header.scss
├── _layout.scss
├── _sidebar-content.scss
└── _syntax-highlighting.scss
├── back.md
├── categorites.html
├── css
├── bootstrap.min.css
└── main.scss
├── feed.xml
├── images
├── development
│ ├── Nagasakibomb.jpg
│ └── gayhub.png
├── entertainment
│ └── fun
│ │ ├── banner.png
│ │ ├── blinkenlights.png
│ │ ├── cmatrix.png
│ │ ├── cowsay.png
│ │ ├── figlet.png
│ │ ├── lolcat.png
│ │ ├── sl.png
│ │ ├── toilet.png
│ │ └── xeyes.png
├── novice
│ ├── bluescreen.png
│ ├── ctrl-alt-delete.jpg
│ └── how-to-ask.png
├── toy
│ ├── Raspberry_Pi_2.jpg
│ └── arduino2048sketches.png
└── work
│ ├── fbx.jpg
│ ├── latex1.png
│ └── sfexpress.jpg
├── index.html
├── js
├── anchor.min.js
├── callout.js
├── faq.js
├── index.js
└── search.js
├── search.html
└── static
└── js
├── index.js
├── search.js
└── share.js
/.gitignore:
--------------------------------------------------------------------------------
1 | _site
2 | .sass-cache
3 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # intro
2 |
3 | [upclinux.github.io/intro](https://upclinux.github.io/intro)
4 |
5 | 网站上总结了一些新手常见的问题。
6 |
7 | 注意本项目的名字是入门指“引”,不是指“导”。为了使 Linux 新手不会太受折磨,又不会打消折腾电脑的乐趣,我们只列一些有关“思路”、“注意事项”的东西。具体操作仍需自己探索或找搜索引擎。
8 |
9 | 本网站不打算成为百科全书。可以访问 [Deepin Wiki](http://wiki.deepin.org),这是一个很好的手册。
10 |
11 | # 如何编辑本网站
12 |
13 | 见[这里](https://github.com/upclinux/upclinux.github.io),进去之后往下看。
14 |
15 | 需要注意的是,本 Repo 的分支不是 master,而是 gh-pages,说明这是个子页面。在本地调试的时候,网址应该是 `http://127.0.0.1:4000/intro/` 并且尾部的斜线不能丢。
16 |
17 | # 本网站的黑科技
18 |
19 | 本网站仍然采用 Jekyll 博客系统。但这次毕竟不是博客,因此还要重新设计主题,使其看起来更像个帮助系统。
20 |
21 | ## 如何保证顺序
22 |
23 | 我们仍然使用博客的“分类”来组织文章,不过这次分类和文章都是有顺序的,所以文章的“发布时间”是有要求的。按照“规定的时间”来发布文章,产生的结果才是按照顺序的。
24 |
25 | 1. 目前有 11 个分类,具体名字和对应目录可以看 `_config.yml`。顺序是确定的,但是为了路径整齐,第一个分类的“发布时间”应该是 2001 年,第二个分类的“发布时间”应该是 2002 年……以此类推。
26 | 2. 在每个分类下面有若干文章。文章的排列顺序是从最新到最旧,所以把第一篇文章的发布日期设定成了 12 月 31 日,第二篇是 12 月 30 日……
27 |
28 | 除了改文件名,还需要修改文件头部的日期,因为 Jekyll 看的是文件内容而不是文件名。
29 |
30 | ## 如何才能被 FAQ “收录”
31 |
32 | 首页有个 FAQ,收录了一些常见问题,点击之后会跳到对应页面。这是自动生成的。
33 |
34 | 博客正文头部会有一段信息,写着标题、日期什么的。这个是可以定制的,所以加了一个 faq 属性。faq 是个数组,数组内容就是 FAQ 中应该收录的问题。
35 |
36 | 下面是一个会被 FAQ 收录的例子:
37 |
38 | ---
39 | layout: post
40 | title: "从何开始"
41 | date: 2001-12-31 00:00:00
42 | faq: ["第一个问题?", "第二个问题?"]
43 | ---
44 |
45 | # 编辑注意事项
46 |
47 | (不完全参考维基百科)
48 |
49 | ## 原则
50 |
51 | 注意版权:不要抄袭、复制他人的劳动果实。如果确实需要复制,请标明来源。公有领域和确实属于自己的作品除外。
52 |
53 | ## 内容
54 |
55 | 1. 启发思路:作为“入门指引”,我们更多的是让读者意识到“是什么”、“有什么”和“能够做什么”。一般不用写特别详细的操作步骤。
56 | 2. 说明书:对于一些特殊的问题,例如“如何安装QQ”是一个不需要点拨的问题,直接告诉读者详细操作即可。
57 | 3. 原创研究:维基百科反对原创研究,但是我们不反对,只要你的研究成果确实有利于读者的学习。
58 | 4. 内容清晰:要让文字内容条理清晰。没有人喜欢杂乱无章的内容,而且,在手机时代没有人喜欢看一个又长又枯燥的段落。
59 | 5. 适度幽默(恶搞):适度幽默,或者采用一些打比方的形式有助于读者理解一些复杂概念。为什么不用呢?
60 |
61 | ## 观点
62 |
63 | 1. 由于读者一般是经验比较少的新手,因此给出合理的观点可能更有利于学习。
64 | 2. 避免谈政治问题。
65 |
66 | ## 论述
67 |
68 | 1. 请尽量以中立的第三人称视角来书写文章。这意味着,使用“我”、“你”、“我们协会”都是不恰当的。
69 | * 文字当然可以使用“我”。在这种情况下,请标清作者是谁(ID 也可)。
70 | 2. 在论述过程中,应该认为自己不属于任何一个团体,也就是说——
71 | * 你没有身份。虽然读者可能基本上都是大学生,但是不要认为你自己也是大学生。
72 | * 没有 “Linux 协会” 这个组织。所以提及 Linux 协会,提及协会人员及事务都是不恰当的。
73 | * 不要提及“石油大学”的事物,因为读者不一定是石油大学的。
74 |
--------------------------------------------------------------------------------
/_config.yml:
--------------------------------------------------------------------------------
1 | # Site settings
2 | title: UPC Linux
3 | email: upclinux@163.com
4 | footnote: > # this means to ignore newlines until "baseurl:"
5 | © 2015 中国石油大学 (华东) Linux 协会
自豪地采用 GitHub Pages 和 Jekyll
6 | baseurl: "/intro" # the subpath of your site, e.g. /blog/
7 | url: "https://upclinux.github.io" # the base hostname & protocol for your site
8 | permalink: /:short_year/:title
9 | # twitter_username: jekyllrb
10 | github_username: upclinux
11 | qqqun_name: "QQ 群 (279310694)"
12 | qqqun_idkey: e47c6b546d3373c09f7eaa8d4173728a513975ed2d0ec20106e83cfb11a3bf08
13 |
14 | host: 0.0.0.0
15 |
16 | # force https
17 | force_https: upclinux.github.io
18 |
19 | # Gems
20 | gems:
21 | - jemoji
22 |
23 | # Build settings
24 | markdown: kramdown
25 |
26 | defaults:
27 | -
28 | scope:
29 | path: ""
30 | type: "posts"
31 | values:
32 | layout: "page"
33 | comments: "true"
34 | -
35 | scope:
36 | path: "novice"
37 | values:
38 | category: "我是新手"
39 | icon: "fa fa-github-alt"
40 | -
41 | scope:
42 | path: "try"
43 | values:
44 | category: "准备接触 Linux"
45 | icon: "fa fa-linux"
46 | -
47 | scope:
48 | path: "configuration"
49 | values:
50 | category: "配置系统"
51 | icon: "fa fa-cogs"
52 | -
53 | scope:
54 | path: "c"
55 | values:
56 | category: "just for C 语言"
57 | icon: "fa fa-bug"
58 | -
59 | scope:
60 | path: "work"
61 | values:
62 | category: "工作与学习"
63 | icon: "fa fa-graduation-cap"
64 | -
65 | scope:
66 | path: "entertainment"
67 | values:
68 | category: "娱乐"
69 | icon: "fa fa-gamepad"
70 | -
71 | scope:
72 | path: "development"
73 | values:
74 | category: "开发者"
75 | icon: "fa fa-code"
76 | -
77 | scope:
78 | path: "network"
79 | values:
80 | category: "网络"
81 | icon: "fa fa-wifi"
82 | -
83 | scope:
84 | path: "toy"
85 | values:
86 | category: "Linux 玩具"
87 | icon: "fa fa-puzzle-piece"
88 | -
89 | scope:
90 | path: "future"
91 | values:
92 | category: "深入学习"
93 | icon: "fa fa-book"
94 | -
95 | scope:
96 | path: "mac"
97 | values:
98 | category: "苹果"
99 | icon: "fa fa-apple"
100 | -
101 | scope:
102 | path: "others"
103 | values:
104 | category: "其他"
105 | icon: "fa fa-smile-o"
106 |
--------------------------------------------------------------------------------
/_includes/footer.html:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/_includes/head.html:
--------------------------------------------------------------------------------
1 |
有些时候,你只是需要一点点提示,剩下的可以自己探索。
8 | GitHub 项目主页
9 | 最后更新: {{ site.time | date: "%Y-%m-%d" }}
\s*?\[%\s*?callout\s*?%\]\s*?<\/p>/g, '
\s*?\[%\s*?callout\s*?%\]\s*?(.*?)<\/p>/; 11 | while (style=reg.exec(text)) { 12 | text=text.replace(reg, '
\s*?\[%\s*?callout\s+?style\s*?=\s*?["]{0,1}(.*?)["]{0,1}\s*?%\]\s*?<\/p>/; 16 | var reg2 = /
\s*?\[%\s*?callout\s+?style\s*?=\s*?["]{0,1}(.*?)["]{0,1}\s*?%\]\s*?(.*?)<\/p>/; 17 | while (style=reg.exec(text)) { 18 | text=text.replace(reg, '
\s*?\[%\s*?endcallout\s*?%\]\s*?<\/p>/g, '