長垣高端建站,重慶公司注冊費用是多少,wordpress產(chǎn)品列表頁,制作網(wǎng)站注意哪些問題原文#xff1a;towardsdatascience.com/how-to-export-a-stata-notebook-to-html-02ec2984da18 在數(shù)據(jù)項目協(xié)作中#xff0c;有效地分享你的工作至關(guān)重要。雖然發(fā)送帶注釋的代碼在某些情況下可能足夠#xff0c;但有時這還不夠。 我將坦白地說#xff0c;我不喜歡使用 St…原文towardsdatascience.com/how-to-export-a-stata-notebook-to-html-02ec2984da18在數(shù)據(jù)項目協(xié)作中有效地分享你的工作至關(guān)重要。雖然發(fā)送帶注釋的代碼在某些情況下可能足夠但有時這還不夠。我將坦白地說我不喜歡使用 Stata。從編程角度來看我發(fā)現(xiàn)它的語法非常反直覺。但我的主要問題是如果你不通過共享數(shù)據(jù)和 do 文件不清楚如何分享你的工作因為其他人可以自己運行它。如果你們兩個人都在使用代碼那沒問題。然而很多時候其他人只想看到結(jié)果并了解你是如何實現(xiàn)的。自己運行代碼最多是浪費時間最壞的情況是成為一項后勤挑戰(zhàn)。盡管如此我仍然需要使用這個 Stata因為它在經(jīng)濟學(xué)研究中被廣泛使用。但現(xiàn)在我發(fā)現(xiàn)了解決這個問題的最佳方法。那就是使用webdoc命令。在閱讀完這篇文章后你將能夠?qū)⒛愕拇a例如這個*Stata code*Name:Your Name*Date:October2024clearallcdyour/directory/sysuse auto*Regression n°1regress price mpg*Graphs twoway(scatter price mpg)(lfit price mpg)轉(zhuǎn)換為如下可分享的 HTML 文檔https://github.com/OpenDocCN/towardsdatascience-blog-zh-2024/raw/master/docs/img/971b6780cf4b3d7859320074e5d12273.png作者提供的圖片現(xiàn)在想象一下所有可能的情況在這篇文章中我將涵蓋以下內(nèi)容什么是 webdoc如何安裝 webdoc如何開始使用 webdoc使用 Markdown 而不是 HTML添加目錄格式化你的 HTML 文檔即讓它看起來很棒 我將介紹我認為你可以立即開始使用的基礎(chǔ)工具來有效地分享你的工作。然而你可以通過查看此命令的官方文檔 [1]它也以網(wǎng)絡(luò)格式提供 這里 來深入了解。現(xiàn)在讓我們深入探討1. 什么是 webdocwebdoc 是一個由 Stata 社區(qū)貢獻的命令用于處理包含 Stata 命令以及 HTML 或 Markdown 代碼片段的 do 文件。webdoc 的主要目的是生成一個 HTML 文檔該文檔顯示 Stata 輸出與軟件結(jié)果窗口中顯示的相同。然而如果你更熟悉這種標記語言它也可以創(chuàng)建 Markdown 文檔。稍后你可以使用像pandoc這樣的其他軟件將 Markdown 轉(zhuǎn)換為 HTML以便更容易與他人分享。2. 如何安裝 webdoc要能夠在 Stata 中使用webdoc命令你首先需要通過在 Stata 控制臺中運行以下行來安裝它ssc install webdoc,replace要檢查更新你可以輸入adoupdate webdoc安裝了 webdoc 后讓我們繼續(xù)創(chuàng)建第一個包含 Stata 代碼和 HTML 注釋的 do 文件。3. 如何開始使用 webdoc基本的想法是創(chuàng)建一個名為 do 文件的文件。這個文件應(yīng)該包含 Stata 命令和 HTML 代碼的部分。然后我們可以使用webdoc do命令處理 do 文件。讓我們按照上面提供的示例代碼進行操作。首先我們將使用webdoc init命令在開頭設(shè)置 do 文件。然后你想要在 HTML 最終文檔中以文本形式出現(xiàn)的每個注釋你都將寫作/*** text ***/。下面是如何操作的webdoc init example,replace logall/***htmlheadtitleExample/title/headbodyh1Stata code/h1pName:Your NameppDate:October2024p***/sysuse auto/***h3Regression n°1./h3***/regress price mpg/***h3Graphs/h3***/twoway(scatter price mpg)(lfit price mpg)webdoc graph,caption(Figure1:Twoway plot of price by milage)cabove///title(price by mpg)attributes(width100%)/***/body/html***/我還添加了webdoc graph命令以便在上面的代碼行中包含由 Stata 創(chuàng)建的散點圖。最后為了處理你的文件只需在 Stata 命令面板上運行webdoc do example.do命令將創(chuàng)建 HTML 源文件然后可以在瀏覽器中查看看起來應(yīng)該像這樣https://github.com/OpenDocCN/towardsdatascience-blog-zh-2024/raw/master/docs/img/e659066edf4101c08fbfa200393f4558.png圖片由作者提供到目前為止我們使用了logall選項它告訴軟件將所有 Stata 命令和輸出包含到最終文檔中。但有一些方法可以編輯它。stlog選項webdoc stlog有幾個選項可以用來操作要包含在輸出部分的內(nèi)容。我使用最多的有nooutput: 這允許你只顯示你運行的命令但不顯示輸出。這在清理數(shù)據(jù)或創(chuàng)建新變量時特別有用。nolog: 與前一個nolog相反nolog包含輸出但不包括剛剛運行的命令。對于我們一直在跟蹤的示例第二個選項可以適用于圖形命令。我們將編輯該部分使其現(xiàn)在看起來像這樣/***h3Graphs/h3***/webdoc stlog,nolog twoway(scatter price mpg)(lfit price mpg)webdoc stlog close webdoc graph,caption(Figure1:Twoway plot of price by milage)cabove///title(price by mpg)attributes(width100%)4. 使用 Markdown 而不是 HTML現(xiàn)在讓我們說實話隨著你代碼的推進在 Stata 的注釋中編寫 HTML 確實是一種痛苦的經(jīng)歷。你可以嘗試在你的代碼編輯器中打開文檔但需要在軟件界面之間切換這可能有些麻煩。這就是為什么我更喜歡通過使用 Markdown 而不是 HTML 來格式化 Stata 中的文本。它更簡單更快地適應(yīng)因為沒有那么多語法需要記住和編寫。如果你不太熟悉 Markdown我在這里給你留下一個簡短的介紹這里?，F(xiàn)在你只需要使用webdoc init命令的md選項。例如你可以在 do 文件的開頭這樣寫webdoc init example,replace logall md這使得輸出文件使用.md后綴而不是.html?，F(xiàn)在你可以簡單地使用 Markdown 編寫所有的/*** text ***/。如果我們將前面的示例轉(zhuǎn)換成 Markdown我們得到如下內(nèi)容webdoc init example,replace logall md/***# Stata codeName:Your Name Date:October2024***/sysuse auto/***### Regression n°1.***/regress price mpg/***### Graphs***/twoway(scatter price mpg)(lfit price mpg)webdoc graph,caption(Figure1:Twoway plot of price by milage)cabove///title(price by mpg)attributes(width100%)這看起來不是更干凈嗎將 Markdown 文檔轉(zhuǎn)換為 HTML一旦你創(chuàng)建了一個包含所有注釋、代碼和輸出的 Markdown 文檔你將想要將其轉(zhuǎn)換成一個可分享的 HTML 文檔這是一個用戶友好的方式來展示你的工作。我這樣做是通過在我的終端上使用pandoc。如果你已經(jīng)安裝了 pandoc你可以移動到包含你想要轉(zhuǎn)換的 markdown 文件的目錄然后運行以下代碼塊pandoc example.md-s-o example.html這將從“example.md”文件中生成一個 HTML 文檔。5. 添加目錄為什么添加目錄我們將 Stata 代碼轉(zhuǎn)換成可共享文檔的主要目標是使與我們合作的人更容易訪問與他們相關(guān)的信息。因此在展示一段長代碼時添加目錄可以極大地幫助您輕松地瀏覽文檔。如何添加目錄要從 HTML 文檔中的標題生成可點擊的目錄TOC你可以使用webdoc toc命令。簡單地在你想要目錄出現(xiàn)的位置的 do 文件中包含該命令。從該位置之后的所有標題將被收集以構(gòu)建目錄。默認情況下該命令收集標題從to.為了使webdoc toc查找 Markdown 標題你必須指定如下所示的md選項webdoc toc md6. 格式化 HTML要編輯文檔的外觀最直接的方式是使用與webdoc init命令一起使用的header()選項。下面是設(shè)置最初顯示的最終 HTML 文檔所使用的代碼webdoc init example,replace logall md header(title(Stata Code)width(800px)stscheme(ocean)bstheme(cosmo,selfcontained))子選項title()指定 HTML 文檔頭部的標簽文本子選項width()設(shè)置最大頁面寬度。我喜歡使用 800px。然后是另外兩個子選項stscheme()和bstheme()我將在下面詳細解釋。格式化 Stata 輸出通過使用header()選項內(nèi)的子選項stscheme()來快速開始自定義文檔的外觀。這個子選項可以用來更改 stata 輸出的主題你可以選擇以下選項標準、工作室、簡單、沙漠、山脈、海洋和經(jīng)典。為了給您一個更好的概念這里有一張圖片展示了每個主題下簡單回歸的樣式。https://github.com/OpenDocCN/towardsdatascience-blog-zh-2024/raw/master/docs/img/87a64d3f22ff61d9b646073a8eb51045.png作者提供的圖片使用 Bootstrap修改文檔的另一種方式是通過使用bstheme()子選項來包含一個 Bootstrap CSS 文件。在示例中我使用了bootswatch的cosmo主題但你也可以使用你最喜歡的任何主題。在包含我們討論的所有格式化選項之后你應(yīng)該能夠?qū)⒊跏?HTML 文檔轉(zhuǎn)換成如下所示的好看的文檔。https://github.com/OpenDocCN/towardsdatascience-blog-zh-2024/raw/master/docs/img/a7e290b9895faea856cf5405029e19b1.png作者提供的圖片結(jié)論使用 webdoc 創(chuàng)建可分享的 HTML 文檔為您提供了一個強大的方式以用戶友好的格式展示您的工作。不再需要要求合作者運行您的代碼現(xiàn)在您可以向他們提供他們所需的一切——輸出、圖表和解釋——都在一個地方。通過有效地使用這些工具您可以節(jié)省時間并使您的團隊能夠更容易地專注于結(jié)果。下次您在 Stata 中處理數(shù)據(jù)項目時嘗試使用 webdoc 命令并將您的協(xié)作提升到新的水平。參考文獻[1] Jann, Ben (2017). 在 Stata 中使用 webdoc 創(chuàng)建 HTML 或 Markdown 文檔。Stata 期刊 17(1): 3–38.