{"id":18339526,"url":"https://github.com/asciidoctor/asciidoctor-fb2","last_synced_at":"2026-02-28T14:31:30.930Z","repository":{"id":43414114,"uuid":"279425043","full_name":"asciidoctor/asciidoctor-fb2","owner":"asciidoctor","description":"📕 Asciidoctor FB2 is an Asciidoctor extension for converting AsciiDoc to FB2","archived":false,"fork":false,"pushed_at":"2026-01-27T22:24:43.000Z","size":145,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-28T11:06:22.926Z","etag":null,"topics":["asciidoc","asciidoctor","ebook","fb2","ruby","rubygem"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asciidoctor.png","metadata":{"files":{"readme":"README.adoc","changelog":"CHANGELOG.adoc","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-07-13T22:30:26.000Z","updated_at":"2026-01-27T22:24:46.000Z","dependencies_parsed_at":"2023-12-13T19:13:25.602Z","dependency_job_id":"b277c948-3a5f-40dc-886c-7d4feac103e8","html_url":"https://github.com/asciidoctor/asciidoctor-fb2","commit_stats":{"total_commits":114,"total_committers":2,"mean_commits":57.0,"dds":"0.26315789473684215","last_synced_commit":"af5acf827dfcbaa136013f24eff6772283dbd479"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/asciidoctor/asciidoctor-fb2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor-fb2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor-fb2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor-fb2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor-fb2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asciidoctor","download_url":"https://codeload.github.com/asciidoctor/asciidoctor-fb2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor-fb2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29937391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-28T13:49:17.081Z","status":"ssl_error","status_checked_at":"2026-02-28T13:48:50.396Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asciidoc","asciidoctor","ebook","fb2","ruby","rubygem"],"created_at":"2024-11-05T20:18:17.278Z","updated_at":"2026-02-28T14:31:30.907Z","avatar_url":"https://github.com/asciidoctor.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"= {project-name}\nMarat Radchenko \u003cmarat@slonopotamus.org\u003e\n:project-name: Asciidoctor FB2\n:project-handle: asciidoctor-fb2\n:slug: asciidoctor/{project-handle}\n:source-highlighter: rouge\n:uri-project: https://github.com/{slug}\n:uri-ci: {uri-project}/actions?query=branch%3Amaster\n:uri-gem: https://rubygems.org/gems/{project-handle}\n\nimage:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[project chat,link=https://asciidoctor.zulipchat.com/]\nimage:https://img.shields.io/gem/v/{project-handle}.svg[Latest Release,link={uri-gem}]\nimage:{uri-project}/actions/workflows/ci.yml/badge.svg?branch=main[Build Status,link={uri-ci}]\n\n{project-name} is an Asciidoctor extension for converting AsciiDoc documents directly to the FB2 e-book format.\n\n== Installation\n\n{project-name} is published on RubyGems.org.\nYou can install the published gem using the following command:\n\n[source,shell script]\n----\n$ gem install asciidoctor-fb2\n----\n\nAssuming all the required gems install properly, verify you can run the `{project-handle}` script:\n\n[source,shell script]\n----\n$ asciidoctor-fb2 -v\n----\n\nIf you see the version of {project-name} printed, you're ready to use {project-name}.\n\n== Usage\n\nConverting an AsciiDoc document to FB2 is as simple as passing your document to the `{project-handle}` command.\nThis command should be available on your PATH if you installed the `{project-handle}` gem.\nOtherwise, you can find the command in the [path]_bin_ folder of the project.\nWe also recommend specifying an output directory using the `-D` option flag.\n\n[source,shell]\n----\n$ asciidoctor-fb2 -D output path/to/book.adoc\n----\n\nWhen the script completes, you'll see the file [file]_book.fb2.zip_ appear in the [path]_output_ directory.\nOpen that file with an FB2 reader to view the result.\n\n== FB2-related AsciiDoc Attributes\n\nThe metadata in the generated FB2 file is populated from attributes in the AsciiDoc document.\nThe names of the attributes and the metadata elements to which they map are documented in this section.\n\n.AsciiDoc attributes that control the FB2 metadata\n[cols=\"1m,3\"]\n|===\n|Name |Description\n\n|uuid\n|Populates unique book identifier in FB2 metadata.\n\n|lang\n|Populates the content language in FB2 metadata.\n\n|keywords\n|Populates keywords list in FB2 metadata.\nThe keywords should be represented as comma-separated values (CSV).\n\n|genres\n|Populates genres list in FB2 metadata.\nThe genres should be represented as comma-separated values (CSV).\n\n|front-cover-image\n|Specifies path to front cover image.\n|===\n\n== Development\n\nAfter checking out the repo, run `bundle install` to install dependencies.\nThen, run `bundle exec rake spec` to run the tests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoctor%2Fasciidoctor-fb2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasciidoctor%2Fasciidoctor-fb2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoctor%2Fasciidoctor-fb2/lists"}