commafeed下載 - commafeed原始碼下載

commafeed

JAVA源碼

Comma

下載

逗號提要

Google Reader 啟發了自託管 RSS 閱讀器，基於 Quarkus 和 React/TypeScript。

特徵

4種不同的佈局
淺色/深色主題
完全響應式，在行動裝置和桌面裝置上都能很好地工作
幾乎所有內容的鍵盤快捷鍵
支援從右到左提要
翻譯成超過 25 種語言
支援數千名用戶和數百萬個提要
OPML 匯入/匯出
休息API
適用於本機行動應用程式的 Fever 相容 API
可以根據使用者定義的規則自動將文章標記為已讀
瀏覽器擴充
編譯為本機程式碼，實現極快的啟動速度和低記憶體使用率
支援4個資料庫
- H2（嵌入式資料庫）
- PostgreSQL
- MySQL
- 瑪麗亞資料庫

部署

碼頭工人

Docker 是開始使用 CommaFeed 的最簡單方法。

Docker 映像像是自動建置的，可從 https://hub.docker.com/r/athou/commafeed 取得

雲端託管

PikaPods 提供一鍵式雲端託管解決方案，起價為每月 1 美元，並提供 5 美元的免費歡迎積分，並正式支援 CommaFeed。 PikaPods 將 20% 的收入分享給 CommaFeed。

下載預編譯包

前往發行頁面並下載適合您選擇的作業系統和資料庫的最新版本。

有兩種類型的包：

linux-x86_64和windows-x86_64軟體包是本機編譯的，並且包含可以直接運行的可執行檔。
jvm包是一個 zip 文件，其中包含運行應用程式所需的所有.jar檔。該套件適用於所有平台，並以java -jar quarkus-run.jar啟動。

如果您的作業系統可用，建議使用本機包，因為它具有更快的啟動時間和更低的記憶體使用量。

從源頭構建

 ./mvnw clean package [-P<database>] [-Pnative] [-DskipTests]

<database>可以是h2 、 postgresql 、 mysql或mariadb之一。預設為h2 。
-Pnative將應用程式編譯為本機程式碼。這需要安裝 GraalVM（ GRAALVM_HOME環境變數指向 GraalVM 安裝）。
-DskipTests透過跳過測試來加速建置過程。

建置完成後：

包含執行應用程式所需的所有 jar 的 zip 位於commafeed-server/target/commafeed-<version>-<database>-jvm.zip 。解壓縮它並使用java -jar quarkus-run.jar運行應用程式
如果您使用本機設定文件，則可執行檔位於commafeed-server/target/commafeed-<version>-<database>-<platform>-<arch>-runner[.exe]

配置

CommaFeed 不需要任何配置即可與其嵌入式資料庫 (H2) 一起運作。資料庫檔案將存放在目前目錄的data目錄下。

要使用不同的資料庫，您需要配置以下屬性：

quarkus.datasource.jdbc.url
- 例如對於 H2： jdbc:h2:./data/db;DEFRAG_ALWAYS=TRUE
- 例如對於 PostgreSQL： jdbc:postgresql://localhost:5432/commafeed
- 例如對於 MySQL： jdbc:mysql://localhost/commafeed?autoReconnect=true&failOverReadOnly=false&maxReconnects=20&rewriteBatchedStatements=true&timezone=UTC
- 例如 MariaDB： jdbc:mariadb://localhost/commafeed?autoReconnect=true&failOverReadOnly=false&maxReconnects=20&rewriteBatchedStatements=true&timezone=UTC
quarkus.datasource.username
quarkus.datasource.password

配置 CommaFeed 的方法有多種：

相對於工作目錄的config/application.properties屬性檔（短橫線大小寫的鍵）
命令列參數以-D為前綴（短橫線大小寫的鍵）
環境變數（大寫字母）
工作目錄中的.env檔（大寫字母）

建議使用屬性文件，因為 CommaFeed 將能夠警告無效屬性和拼字錯誤。

所有 CommaFeed 設定都是可選的，並且具有合理的預設值。

登入時，憑證會儲存在加密的 cookie 中。加密金鑰是在啟動時隨機產生的，這意味著您每次重新啟動應用程式後都必須重新登入。為了防止這種情況，您可以將quarkus.http.auth.session.encryption-key屬性設定為固定值（最少 16 個字元）。所有其他 Quarkus 設定都可以在此處找到。

啟動後，伺服器將偵聽 http://localhost:8082。預設使用者是admin ，預設密碼是admin 。

更新

當 CommaFeed 啟動並運行時，您可以訂閱此來源以取得新版本的通知。

記憶體管理

Java 虛擬機器 (JVM) 預設相當貪婪，不會將未使用的記憶體釋放給作業系統。這是因為從作業系統取得記憶體是一個相對昂貴的操作。這在記憶體有限的系統上可能會出現問題。

硬限制（ `native`和`jvm`包）

可以使用-Xmx參數將 JVM 配置為使用最大記憶體量。例如，要將 JVM 記憶體限制為 256MB，請使用-Xmx256m 。

動態調整大小（ `jvm`包）

除了前面的設定之外，還可以使用以下參數配置 JVM 將未使用的記憶體釋放給作業系統：

 -Xms20m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:-ShrinkHeapInSteps -XX:G1PeriodicGCInterval=10000 -XX:-G1PeriodicGCInvokesConcurrent -XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=10

請參閱此處和此處以了解更多資訊。

OpenJ9（ `jvm`套件）

OpenJ9 JVM 是 HotSpot JVM 的記憶體效率更高的替代方案，但代價是吞吐量稍慢。

IBM 為 OpenJ9 提供了名為 Semeru 的預編譯二進位。這是 Docker 映像中使用的 JVM。

翻譯

國際化文件位於此處。

新增語言：

將新區域設定新增至locales數組：
- commafeed-client/.linguirc
- commafeed-client/src/i18n.ts
運行npm run i18n:extract
將翻譯新增至新建立的commafeed-client/src/locales/[locale]/messages.po文件

區域設定的名稱應該是兩個字母的 ISO-639-1 語言代碼。