开源软件期刊

《开源软件期刊](https://joss.theoj.org)（Journal of Open Source Software, JOSS）是一本面向开发者的研究软件包期刊。

你所说的“journal”具体是什么意思

《开源软件期刊》（JOSS）是一本具有正式同行评审流程的学术期刊，旨在_提升所提交软件的质量_。论文被 JOSS 接收后，将生成一个 CrossRef DOI，我们会在 JOSS 网站上列出您的论文。

我们不是已经有足够的日志了吗？

在一个完美的世界里，关于软件的论文是不必要的。不幸的是，对于大多数研究人员来说，学术地位依赖于论文而非软件，因此，引用对于成功的职业生涯至关重要。

We built this journal because we believe that after you've done the hard work of writing great software, it shouldn't take weeks and months to write a paper¹ about your work.

你说开发者友好，这是什么意思？

我们有一个简单的提交工作流程和详尽的文档，以帮助您准备提交。如果您的软件已经拥有完善的文档，那么论文准备工作不应超过一小时。

¹ After all, this is just advertising.

该网站

JOSS 提交工具托管于 https://joss.theoj.org

JOSS 评审

如果您正在寻找 JOSS 评审仓库，请前往此处：https://github.com/openjournals/joss-reviews/issues

行为准则

为了拥有一个更加开放和包容的社区，JOSS 遵循改编自 Contributor Covenant 的行为准则。

请在您在 JOSS 社区中的任何互动中遵守本行为准则。该准则在所有官方 JOSS 仓库、JOSS 网站及资源上均严格执行。如果您遇到有人违反这些条款，请告知主编（@arfon）或编辑委员会中的任何人，我们将尽快处理。

贡献

1. Fork 它
2. 创建你的功能分支 (git checkout -b my-new-feature)
3. 提交你的更改 (git commit -am 'Added some feature')
4. 推送到分支 (git push origin my-new-feature)
5. 创建一个新的 pull request

⚙️ 开发

PostgreSQL 和 Elasticsearch 应在本地安装并运行，以便 JOSS 正常工作

1. Install packages with bundler - bundle install
2. Set rails env in your shell (or prepend to each command): export RAILS_ENV=development
3. Create the database with bin/rails db:create
4. Run any pending db migrations bin/rails db:migrate
5. (Optional) seed the data with demo data (see db/seeds.rb) bin/rails db:seed
6. After running elasticsearch, create an index with curl -X PUT http://localhost:9200/joss-production Note - you may need to disable the default security settings of elasticsearch by editing your config/elasticsearch.yml
7. Create search indexes: bin/rails searchkick:reindex:all
8. Run bin/rails s

MacOS 笔记

启动时您可能会遇到如下错误：

Started GET "/" for 127.0.0.1 at 2024-08-15 13:03:02 -0700
objc[41226]: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called.
objc[41226]: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug.

要解决此问题，请在您的 shell 文件或 shell 本身中添加：

export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES

参见 rails#38560