| chapters | Initial commit | |
| images | Initial commit | |
| CHANGELOG.md | Initial commit | |
| CODE_OF_CONDUCT.md | Initial commit | |
| CONTRIBUTING.md | update Contributing | |
| HISTORY.md | Initial commit | |
| LICENSE.txt | Initial commit | |
| NEWS.md | Initial commit | |
| oWoF.adoc | Initial commit | |
| README.md | Update Readme | |
| STYLE_GUIDE.md | Update Style Guide | |
oPEN Writing oN Fedora
Syntax AsciiDoc - license cc by 4.0 - become a contributor
oPEN Writing oN Fedora (oWoF) is a collaborative book written in AsciiDoc markup language, which contains guides to software tools useful to authors using the Fedora operating system and any other GNU/Linux system. Each version of the book corresponds to a specific release version of Fedora.
Table of Contents
Introduction
Welcome to Open Writing on Fedora repository! This collaborative project serves as a comprehensive guide for authors interested in leveraging the Fedora operating system and the wider ecosystem of free and open-source software (FLOSS) tools for their writing endeavors: it covers a wide range of topics, including writing tools, publishing software, and productivity applications. While the content of this book is tailored to Fedora users, it is important to emphasize that our audience extends beyond the Fedora community.
Open Writing on Fedora is intended to cater not only to experienced Fedora users but also to those who may be unfamiliar with Fedora, GNU/Linux, and FLOSS. The primary objective is to introduce authors, regardless of their background or familiarity with open-source software, to the wealth of writing tools available in the open-source community.
Whether you're a seasoned writer looking to explore new tools or a newcomer to the world of open-source software, this book-project is for you. The goal is to bridge the gap between proprietary software and the vast ecosystem of open-source tools available to authors, empowering writers of all skill levels to make use of professional-quality writing tools.
In this repository, you'll find documentation written in AsciiDoc format, covering a broad spectrum of topics relevant to authors, including writing and editing tools, publishing software, and productivity applications. Each section provide practical guidance, tutorials, and recommendations.
We invite you to explore the contents of Open Writing on Fedora and discover the myriad possibilities that Fedora and open-source software offer to authors. Whether you're a novelist, journalist, academic, or technical writer, this book is written to help and empower you in your writing journey.
If you have any questions, feedback, or suggestions for improvement, please don't hesitate to reach out to us. We are committed to fostering a supportive and inclusive community where authors can thrive and succeed in their writing endeavors.
Goals
To fully understand the foundation and intentions of this project, please read the HISTORY.md file.
Contributing
We need contributions from the community! If you have knowledge or expertise in any area relevant to authors on Fedora, or on other GNU/Linux distributions, or with open-source software in general, feel free to contribute by submitting pull requests. Whether you're experienced with Fedora, another GNU/Linux distribution, or open-source software, your insights and contributions are invaluable to us.
Your contributions can range from documentation improvements, code enhancements, bug fixes, to suggestions for new features or tools. Every contribution, no matter how small, helps improve the quality and usefulness of Open Writing on Fedora for our community of authors.
Make sure to follow our contributing guidelines for more details on how to contribute effectively.
Building
To build the book locally, you'll need to have asciidoctor installed on your system. Once installed, you can use the provided build script to generate the book in your preferred format as PDF, HTML, or DocBook.
To generate the book in PDF formats run the following command in GNU/Linux terminal:
where OUTPUTFILE is the name of your output file that can have the extension .pdf
$ asciidoctor-pdf -o OUTPUTFILE.pdf oWoF.adoc
HTML
To generate the book in HTML formats run the following command in GNU/Linux terminal:
where OUTPUTFILE is the name of your output file that can have the extension .html
$ asciidoctor -o OUTPUTFILE.html oWoF.adoc
DocBook
To generate the book in HTML formats run the following command in GNU/Linux terminal:
$ asciidoctor -b docbook oWoF.adoc
To see all convert option, see the official documentation at: https://docs.asciidoctor.org/asciidoctor/latest/convert/
License
This project is licensed under CC BY-SA 4.0 - see the LICENSE file for more details.