該存儲庫包含:
該存儲庫的官方住所是https://github.com/acl-org/acl-anthology。
有關詳細信息,請參閱單獨的讀書文件以獲取Python軟件包。
這些是在https://aclanthology.org/上看到的有關生成ACL選集網站的基本說明。
要構建選集網站,您將需要:
bin/requirements.txt
中列出的python軟件包;要安裝,運行pip -r bin/requirements.txt
make
之前安裝libyaml-dev
和Cython
,則將使用Libyaml C庫代替Python實現,從而加快了構建。直接從Github執行部署的GitHub動作動作。要使用此功能,您需要在存儲庫設置(Web界面:設置 - >秘密)中定義此變量:
PUBLISH_SSH_KEY
:標準PEM格式的秘密鍵用於身份驗證(無密碼)然後,每當主分支更改時,GitHub將自動構建和部署當前主機。這是通過makefile中的upload
目標完成的。
克隆您本地機器的選集回購:
$ git clone https://github.com/acl-org/acl-anthology
只要您已經正確安裝了所有要求,構建網站應該是從克隆回購的目錄中簡單運行的make
。
完整生成的網站之後將在build/anthology
集中進行。如果在此步驟中發生任何錯誤,您可以諮詢詳細的讀書文件,以獲取有關為構建網站執行的各個步驟的更多信息。您可以通過啟動使用make serve
本地Web服務器來查看所得網站,該網站將在http:// localhost:8000上提供服務。
請注意,構建網站是一個相當大的資源密集過程。尤其是援引雨果的最後一步使用了大約18 〜GB的系統內存。在帶有SSD的筆記本電腦上建造大約10分鐘的選集。
(注意:這並不意味著您需要係統中的這一數量的RAM;實際上,該網站在帶有8 GB RAM的筆記本電腦上構建良好。但是,系統可能由於交換而暫時放慢,但是大約。 18 GB是在運行hugo --minify --stepAnalysis
。)
可以通過在hugo/
Directory中運行hugo server
在本地查看選集。請注意,它可以重建網站,因此需要大約一分鐘的時間才能開始。
首先,創建鏡子很慢,強調ACL選集基礎架構,因為在初始設置中,您必須從官方Web服務器下載選集的每個文件。無論您的連接速度多快,最多可能需要8個小時。因此,請不要為了娛樂而玩這個。
如果要託管鏡子,則必須設置兩個環境變量:
ANTHOLOGY_PREFIX
http前綴您的鏡子將在例如https://example.com/my-awsome-mirror或http://aclanthology.lst.lst.uni-saarland.de(請注意,最後都沒有Slash!)ANTHOLOGYFILES
將文件,附件等居住在您的網絡服務器上的目錄。該目錄需要由您的網絡服務器可讀(顯然),但不應是選集鏡像目錄的子目錄。設置這些變量,您可以make
以創建頁面並make mirror
,以將所有其他文件鏡像構建/選集文件目錄。如果您之前創建了鏡像,它將僅下載丟失的文件。
如果您想鏡像紙,但不是全部附件,則可以運行make mirror-no-attachments
。
然後,您將build/website/
目錄與Web服務器聯繫起來,或者,如果您將鏡像在子目錄FOO
中提供鏡子,則鏡像build/website/FOO
。 build/anthology-files
目錄需要與Web服務器的ANTHOLOGYFILES
目錄進行rsync-ed。
由於您可能想保持鏡像的最新狀態,因此您可以根據需要修改Shell腳本bin/acl-mirror-cronjob.sh
。
您將在服務器上需要此軟件
如果您希望構建過程快速,請安裝cython3
和libyaml-dev
(請參見上文)。
請注意,生成選集需要大量RAM,因此請確保它在計算機上可用。
如果您想為ACL選集做出貢獻,請查看:
該倉庫最初是翼/ACL,截至2017年6月5日已轉移到ACL-ORG。
構建ACL選集的代碼是根據Apache許可證v2.0分發的。