国产成+人+综合+亚洲 欧美-国产成+人+综合+亚洲专-国产成+人欧美+综合在线观看-国产成a人片在线观看视频-国产成a人片在线观看视频99-国产成a人片在线观看视频下载

您現在所在的位置:首頁 >關于奇酷 > 行業動態 > 使用 Python 30分鐘 教你快速搭建一個博客

使用 Python 30分鐘 教你快速搭建一個博客

來源:奇酷教育 發表于:

0個優秀的程序員里,有9個人都有寫博客的習慣。這是非常好的習慣,它使得知識得以提煉,轉輸出為輸入,在提升自己的同時,還能利用互聯網易

0個優秀的程序員里,有9個人都有寫博客的習慣。這是非常好的習慣,它使得知識得以提煉,轉輸出為輸入,在提升自己的同時,還能利用互聯網易傳播的特性,將知識分享給每一個熱愛學習的人。這是值得每個程序員,投入時間和精力去堅持做下去的事。博客既然是自己的一個知識寶庫,那么索引將變得極為重要。通過自己的探索,小明發現了一個能夠很好地滿足這個需求的 Python 框架 Sphnix。實現的大體的思路如下:

Markdown:書寫文檔

Pandoc:格式轉化

Sphinx:生成網頁

GitHub:托管項目

ReadtheDocs:發布網頁

  •  

 

接下來,就來看看到底是如何實現的?

 

 

01

 

成品展示


 

以我的博客為例,先給大家展示一下。這是首頁。顯示了你所有的文章索引。

這是我的導航欄。是不是結構很清晰,很方便索引。

點擊文章后,還可以很方便查看標題,跳轉。

體驗下搜索功能,速度很快。

看完這些你是不是也很想擁有這樣一個博客呢?只要你認真往下看,30分鐘搭建這樣一個博客不在話下。

02

 

安裝Sphnix


 

安裝之前,請確認下Python版本。我這里使用的是Python 2.7.14,其他版本請自行嘗試(Py3有點不一樣,不想踩坑的,請跟我一樣使用 Py2)。安裝Python工具包$ pip install sphinx sphinx-autobuild sphinx_rtd_theme
初始化# 先創建一個工程目錄:F:\\mkdocs
$ cd F:\\mkdocs

$ sphinx-quickstart
執行這個命令sphinx-quickstart的時候,會讓你輸入配置。除了這幾個個性化配置,其他的都可以按照默認的來。> Project name: MING's BLOG
> Author name(s): MING
> Project release []: 1.0
> Project language [en]: zh_CN
完了后,就可以看見創建的工程文件。F:\mkdocs
(mkdocs) λ ls -l
total 5
-rw-r--r-- 1 wangbm 1049089 610 Jun 23 16:57 Makefile
drwxr-xr-x 1 wangbm 1049089   0 Jun 23 16:57 build/
-rw-r--r-- 1 wangbm 1049089 817 Jun 23 16:57 make.bat
drwxr-xr-x 1 wangbm 1049089   0 Jun 23 16:57 source/

F:\mkdocs
(mkdocs) λ tree
卷 文檔 的文件夾 PATH 列表
卷序列號為 0002-B4B9
F:.
├─build
└─source
    ├─_static
    └─_templates
解釋下這些文件/夾:

build:文件夾,當你執行make html的時候,生成的html靜態文件都存放在這里。

source:文件夾:你的文檔源文件全部應全部放在source根目錄下。

Makefile:編譯文件。完全不用管。

make.bat:bat腳本。你也不用管。

  •  

 

03

 

配置及擴展


 

Sphinx 的配置文件是 source\conifg.py由于修改的內容比較多而雜,為了使這個搭建過程,更加順暢。小明已經給你精心準備了一份配置文件。你只要關注我的公眾號,后臺直接回復「Sphinx」即可獲取。關于配置文件,我做了哪些事:

配置主題

支持LaTeX

支持中文檢索

以上配置文件,需要搭配擴展模塊才能使用。擴展模塊同樣我也給你準備好了,在你回復「Sphinx」后,獲取壓縮包后,里面有個 exts 文件夾。你只要將這個文件夾原封不動的放置在與source的同級目錄下即可。由于擴展模塊會用到一些第三方依賴包,需要你去包裝它。requirements.txt 同樣我也給你準備好了,在壓縮包里有。你只要執行這個命令,即可安裝。pip install -r requirements.txt -i  www.idiancai.com/simple/
 

04

 

撰寫文章


萬事俱備,接下來要寫文檔了。在source目錄下,新增文件 how_to_be_a_rich_man.rst(至于什么是rst格式呢,請自行搜索引擎噢)文件內容如下第一章 如何成為有錢人
======================

1.1 財富繼承法
---------------------

有個有錢的老爸。


1.2 財富共享法
---------------------

有個有錢的老婆。
寫好文檔后,千萬記得要把這個文檔寫進,目錄排版里面。排版配置文件是 source\index.rst,千萬要注意中間的空行不可忽略。.. toctree::
:maxdepth: 2
:caption: Contents:

   how_to_be_a_rich_man
然后刪除這幾行Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
然后執行make html 生成html靜態文件。F:\mkdocs
(mkdocs) λ make html
Running Sphinx v1.7.4
loading translations [zh_CN]... done
loading pickled environment... done
building [mo]: targets for0 po files that are outof date
building [html]: targets for2 source files that are outof date
updating environment: [extensions changed] 2 added, 0 changed, 0 removed
reading sources... [100%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] index
generating indices... genindex
writing additional pages... search
copying static files... done
copying extra files... done
dumping search indexin English (code: en) ... done
dumping object inventory... done
build succeeded.

The HTML pages are in build\html.
執行完了后,你可以發現原先的build,不再是空文件夾了。我們點進去www.smpeizi.com/ build/html/,打開index.html

點擊 我們剛寫的暴富指南。

05

 

托管項目


 

看到網頁的那一刻是不是相當激動。不過別激動,這只是本地的,我們需要將其發布在線上。這里我將工程文件,托管在GitHub上,然后由Read the Docs發布。在托管之前呢,我們需要準備工作。在mkdocs根目錄下,添加文件.gitignore(聰明的你,肯定知道這是什么),內容如下build/
.idea/
*.pyc
接下來,在你的GitHub上新建一個倉庫。然后把mkdocs這個目錄下的所有文件都提交上去。步驟很簡單,這里就不細講。

06

 

發布上線


托管完成后,我們要發布它,讓別人可以訪問。你需要先去 Read the Docs 注冊下帳號。關聯一下GitHub

 

導入代碼庫。填好與你對應的信息。

 

構建網頁后。右下方,你可以看見你的在線地址www.pzzs168.com。

 

這里要提醒一下的是,Sphinx的文檔格式,默認是 rst 格式,如果你習慣了使用Markdown來寫文章,可以使用 Pandoc 這個神器轉換一下。

這里給出轉換命令。

pandoc -V mainfont="SimSun" -f markdown -t rst hello.md -o hello.rst

或者你也可以在Sphinx上添加支持Markdown渲染的擴展模塊及配置。也很簡單,但是,我發現使用 md 文件,在網站上的導航無法實現跳轉。

到這里,屬于你的個人博客就搭建好了,快去試一下吧。????

主站蜘蛛池模板: 日本性网址 | 成人免费一级毛片在线播放视频 | 全免费a级毛片免费看不卡 全免费a级毛片免费看视频免 | 国产福利资源在线 | 亚洲成人综合视频 | 2019年国产不卡在线刷新 | 中文字幕免费在线播放 | 性久久久久久久久久 | 久久sese| 天天操天天干天天爽 | 亚洲一级毛片欧美一级说乱 | 免费国产成人综合 | 色视频免费国产观看 | 99看片网| 久久久久香蕉视频 | 亚洲欧美中日韩中文字幕 | 亚洲精品久久99久久 | 免费福利入口在线观看 | 欧美日韩中文亚洲v在线综合 | 久久综合九色综合97_ 久久久 | 国产精品久久毛片蜜月 | 欧美日韩视频一区三区二区 | 国产九九热视频 | 精品精品国产高清a毛片牛牛 | 久久这里只有精品18 | 国产91精品久久久久999 | 欧美国产日韩911在线观看 | 国产毛片儿 | 黑人特级粗α级毛片 | 嫩小xxxxx性bbbbb孕妇 | 美日韩视频| 亚洲精品123区在线观看 | 精品久久久久久中文字幕2017 | 五月色婷婷琪琪综合伊人 | 国产综合亚洲专区在线 | 亚洲精品一区91 | 国产欧美日韩综合精品一区二区 | 亚洲人成影院在线高清 | 久久精品国产屋 | 亚洲综合久久综合激情久久 | 亚洲精品国产一区二区图片欧美 |