開源軟件項目通常擁有非常多樣化的用戶人群。有些用戶非常擅長使用該系統(tǒng)，并且只需要很少的文檔。對于這些實力派用戶，文檔只需要提供必要的提示，并且可以包含更多的技術(shù)信息，比如說在 Shell 中運(yùn)行的命令行。有些用戶可能只是初學(xué)者。這些用戶需要更多的幫助來設(shè)置系統(tǒng)并學(xué)習(xí)如何使用它。

創(chuàng)新互聯(lián)專業(yè)為企業(yè)提供旌陽網(wǎng)站建設(shè)、旌陽做網(wǎng)站、旌陽網(wǎng)站設(shè)計、旌陽網(wǎng)站制作等企業(yè)網(wǎng)站建設(shè)、網(wǎng)頁設(shè)計與制作、旌陽企業(yè)網(wǎng)站模板建站服務(wù)，10余年旌陽做網(wǎng)站經(jīng)驗，不只是建網(wǎng)站，更提供有價值的思路和整體網(wǎng)絡(luò)服務(wù)。

寫一個同時適合這兩個用戶群體的文檔是令人生畏的。網(wǎng)站文檔需要在 “提供詳細(xì)的技術(shù)信息” 和 “提供更多的概述和指導(dǎo)” 之間尋求一個平衡。這是一個很難找到的平衡。如果你的文檔不能同時滿足這兩個用戶人群，那么考慮一下另外一個選擇 —— 動態(tài)文檔。

探索在網(wǎng)頁中添加一點(diǎn) ??JavaScript?? 使用戶可以選擇自己想看的內(nèi)容。

構(gòu)建你的內(nèi)容

你可以把例程添加的你的文檔中需要同時滿足 專家expert 和 初學(xué)者novice

你可以用 HTML 編寫一個簡短的安裝文檔，通過 HTML 的 類class

例如，你可以用下面的代碼來為專家定義一個段落：

這同時指派了 “專家類” 和 “讀者類”。你可以用下面的代碼來為初學(xué)者創(chuàng)建一個相同的段落。

完整的 HTML 文件同時包含初學(xué)者的段落和專家的段落。

How to install the software
Thanks for installing AwesomeProject! With AwesomeProject,you can manage your music collection like a wizard.
But first, we need to install it:
You can install AwesomeProject fromsource. Download the tar file, extract it, then run:./configure ; make ; make install
AwesomeProject is available inmost Linux distributions. Check your graphical package manager and search for AwesomeProject to install it.

例子中的 HTML 文檔沒有與之關(guān)聯(lián)的樣式表，所以瀏覽器中會顯示所有的段落。

Image of html in black text.

我們可在文檔中添加一些簡單的樣式來為 讀者reader、專家expert 或者 初學(xué)者novice

How to install the software

當(dāng)你在瀏覽器中查看這個網(wǎng)頁時，這些樣式有助于突出這兩個段落。安裝指導(dǎo)的所有段落都有一個米白色背景，因為他們都有 讀者reader 這個類。第一個段落的字體是深紅色的，這是由 專家expert 這個類定義的。第二個段落的字體是深藍(lán)色的，則是由 初學(xué)者novice

Image of html in red and black text.

添加 JavaScript 控件

這些類的應(yīng)用，使你可以添加一些簡單的 JavaScript 函數(shù)，只顯示其中一個內(nèi)容塊。一個方法是，首先給所有的讀者類元素設(shè)置 ??display:none?? 。這會將內(nèi)容隱藏，使其不會在頁面上顯示。然后，用函數(shù)將你想顯示的類元素設(shè)置為 ??display:block?? :

要在 HTML 文檔中使用這個 JavaScript，你可以吧這個功能附加到一個按鈕上。由于 ??readerview?? 函數(shù)需要一個聽眾audience（這應(yīng)該是相對那個虛擬音樂播放器來說的）作為參數(shù)，你可以使用你想查看的聽眾類別來調(diào)用這個函數(shù)，可以是讀者reader，專家expert 或者 初學(xué)者novice

  
How to install the software
Thanks for installing AwesomeProject! With AwesomeProject,you can manage your music collection like a wizard.
But first, we need to install it:
You can install AwesomeProject fromsource. Download the tar file, extract it, then run./configure ; make ; make install
AwesomeProject is available inmost Linux distributions. Check your graphical packagemanager and search for AwesomeProject to install it.

有了這些設(shè)置，用戶可以在網(wǎng)頁上選擇他們想看的文本。

Image of window that allows you to select between novice and expert text.

點(diǎn)擊任何一個按鈕都將只顯示用戶想要閱讀的文本。例如，如果你點(diǎn)擊了 “閱讀初學(xué)者內(nèi)容view novice text” 按鈕，你就只會看到藍(lán)色段落。

Image showing blue text when you press the novice button.

點(diǎn)擊 “閱讀專家內(nèi)容view expert text” 按鈕，就會隱藏初學(xué)者文本，只顯示紅色的專家文本。

Image of red text after the expert button is clicked.

將此擴(kuò)展到你的文檔

如果你的項目需要你為不同的聽眾編寫多個操作文檔，你可以考慮使用這種方法，一次發(fā)布，多次閱讀。為所有的用戶編寫一個文檔，是每個人都能很容易的發(fā)現(xiàn)和分享你項目的文檔。而你也不必同時維護(hù)盡在細(xì)節(jié)上有所不同的多個文檔。

文章標(biāo)題：使用JavaScript增強(qiáng)你的文檔
文章起源：http://m.5511xx.com/article/ccceodj.html