使用Django怎么渲染Markdown文章目錄-創(chuàng)新互聯(lián)

這篇文章將為大家詳細(xì)講解有關(guān)使用Django怎么渲染Markdown文章目錄,文章內(nèi)容質(zhì)量較高,因此小編分享給大家做個參考,希望大家閱讀完這篇文章后對相關(guān)知識有一定的了解。

成都創(chuàng)新互聯(lián)-專業(yè)網(wǎng)站定制、快速模板網(wǎng)站建設(shè)、高性價比撫寧網(wǎng)站開發(fā)、企業(yè)建站全套包干低至880元,成熟完善的模板庫,直接使用。一站式撫寧網(wǎng)站制作公司更省心,省錢,快速模板網(wǎng)站建設(shè)找我們,業(yè)務(wù)覆蓋撫寧地區(qū)。費(fèi)用合理售后完善,10余年實(shí)體公司更值得信賴。

文中的目錄

之前我們已經(jīng)為博文支持了Markdown語法,現(xiàn)在繼續(xù)增強(qiáng)其功能。

有折騰代碼高亮的痛苦經(jīng)歷之后,設(shè)置Markdown的目錄擴(kuò)展就顯得特別輕松了。

修改文章詳情視圖:

article/views.py

...

# 文章詳情
def article_detail(request, id):
 ...
 article.body = markdown.markdown(article.body,
  extensions=[
  'markdown.extensions.extra',
  'markdown.extensions.codehilite',
   
  # 目錄擴(kuò)展
  'markdown.extensions.TOC',
  ]
 )
 ...

僅僅是將將markdown.extensions.TOC擴(kuò)展添加了進(jìn)去。

TOC: Table of Contents,即目錄的意思

代碼增加這一行就足夠了。為了方便測試,往之前的文章中添加幾個一級標(biāo)題、二級標(biāo)題等。

還記得Markdown語法如何寫標(biāo)題嗎?一級標(biāo)題:# title1,二級標(biāo)題:## title2

然后你可以在文中的任何地方插入[TOC]字符串,目錄就自動生成好了:

使用Django怎么渲染Markdown文章目錄

點(diǎn)擊標(biāo)題,頁面就立即前往相應(yīng)的標(biāo)題處(即“錨點(diǎn)”的概念)。

任意位置的目錄

上面的方法只能將目錄插入到文章當(dāng)中。如果我想把目錄插入到頁面的任何一個位置呢?

也簡單,這次需要修改Markdown的渲染方法:

article/views.py

...

def article_detail(request, id):
 ...

 # 修改 Markdown 語法渲染
 md = markdown.Markdown(
  extensions=[
  'markdown.extensions.extra',
  'markdown.extensions.codehilite',
  'markdown.extensions.toc',
  ]
 )
 article.body = md.convert(article.body)

 # 新增了md.toc對象
 context = { 'article': article, 'toc': md.toc }

 return render(request, 'article/detail.html', context)

為了能將toc單獨(dú)提取出來,我們先將Markdown類賦值給一個臨時變量md,然后用convert()方法將正文渲染為html頁面。通過md.toc將目錄傳遞給模板。

注意markdown.markdown()和markdown.Markdown()的區(qū)別

更詳細(xì)的解釋見:官方文檔

為了將新的目錄渲染到頁面中,需要修改文章詳情模板:

templates/article/detail.html

...

<div class="container">
 <div class="row">
  <!-- 將原有內(nèi)容嵌套進(jìn)新的div中 -->
  <div class="col-9">
   <h2 class="mt-4 mb-4">{{ article.title }}</h2>
   <div class="alert alert-success">
    ...
   </div>
  </div>

  <!-- 新增的目錄 -->
  <div class="col-3 mt-4">
   <h5><strong>目錄</strong></h5>
   <hr>
   <div>
    {{ toc|safe }}
   </div>
  </div>
 </div>
</div>

...
  • 重新布局,將原有內(nèi)容裝進(jìn)col-9的容器中,將右側(cè)col-3的空間留給目錄

  • toc需要|safe標(biāo)簽才能正確渲染

重新打開頁面:

使用Django怎么渲染Markdown文章目錄

關(guān)于使用Django怎么渲染Markdown文章目錄就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,可以學(xué)到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。

本文名稱:使用Django怎么渲染Markdown文章目錄-創(chuàng)新互聯(lián)
文章地址:http://muchs.cn/article4/coehoe.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供網(wǎng)站設(shè)計(jì)、網(wǎng)頁設(shè)計(jì)公司、商城網(wǎng)站域名注冊、外貿(mào)網(wǎng)站建設(shè)建站公司

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)

營銷型網(wǎng)站建設(shè)