devportal
Resources for users of the projects on the Aiven platform (by aiven)
jekyll-multiple-languages-plugin
I18n support for Jekyll and Octopress (by kurtsson)
Our great sponsors
devportal | jekyll-multiple-languages-plugin | |
---|---|---|
3 | 1 | |
59 | 914 | |
- | - | |
9.5 | 10.0 | |
3 months ago | 6 months ago | |
PLpgSQL | Ruby | |
Creative Commons Attribution 4.0 | MIT License |
The number of mentions indicates the total number of mentions that we've tracked plus the number of user suggested alternatives.
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
devportal
Posts with mentions or reviews of devportal.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2023-01-10.
-
Migrating to Docusaurus
Hello folks, I am running a tech writing team (along with product management). I am not expert in documentation platforms. Today we have a challenging custom-built documentation platform based on Sphinx and a bunch of cobbled together technologies aiven/devportal: Resources for users of the projects on the Aiven platform (github.com) . Our documentation is in .rst markup language due to the Python focus.
-
Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code
Humble brag that the last one in the list (Aiven 🦀) won 2022 DevPortal Awards in the category Best DevPortal Beyond REST Platforms. If I added a list of great docs websites but didn't include the OG, it would be a crime. Check out one of THE BEST documentation out there - Stripe Docs, built using Markdoc.
-
Automatically Open Pull Requests with GitHub Actions
You can find a list of Aiven's cloud providers on [Developer.aiven.io], which is also the portal where we host the developer documentation. To quickly retrieve a list of currently-available cloud providers, my colleague Lorna Mitchell wrote a Python script that pulls our cloud listing from the Aiven API and generates documentation, which is really cool!
jekyll-multiple-languages-plugin
Posts with mentions or reviews of jekyll-multiple-languages-plugin.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2023-01-10.
-
Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code
Internationalization (i18n) pain for a documentation project is a process problem, not a feature gap. Documentation frameworks are not meant to translate your developer docs for you into the language of your choice. Some frameworks might offer i18n support, like the Crowdin support in Docusauraus v2. With Jekyll, you have to pick a theme like this one. I doubt if the reST or adoc frameworks would differ much from this process. Besides the framework support, you'll need a localization vendor like lokalise or a community driven platform like Crowdin to actually do the translation. Sébastien goes into great detail in this Docusaurus RFC when discussing i18n support in Docusaurus v2.
What are some alternatives?
When comparing devportal and jekyll-multiple-languages-plugin you can also consider the following projects:
antora
pandoc-action-example - using the pandoc document converter on GitHub Actions
next.js - Markdoc plugin for Next.js
markdown-live-preview - markdown editor with live preview
Vim - The official Vim repository
Docusaurus - Easy to maintain open source documentation websites.
mdx - Markdown for the component era
commonmark-spec - CommonMark spec, with reference implementations in C and JavaScript
create-pull-request - A GitHub action to create a pull request for changes to your repository in the actions workspace
devportal vs antora
jekyll-multiple-languages-plugin vs antora
devportal vs pandoc-action-example
jekyll-multiple-languages-plugin vs next.js
devportal vs markdown-live-preview
jekyll-multiple-languages-plugin vs Vim
devportal vs Docusaurus
jekyll-multiple-languages-plugin vs mdx
devportal vs Vim
jekyll-multiple-languages-plugin vs commonmark-spec
devportal vs create-pull-request
jekyll-multiple-languages-plugin vs markdown-live-preview