thegetty / quire

A multi-package repository for the Quire multiformat publishing framework
https://quire.getty.edu/
BSD 3-Clause "New" or "Revised" License
101 stars 13 forks source link
quire

Quire

About Quire

Developed by Getty, Quire is a digital publishing tool that can create dynamic publications in a variety of formats, including web, print, and e-book. Quire is an ideal tool for publishing beautiful, scholarly digital books optimized for visual imagery and designed to ensure publication content is widely accessible and stable.

Quire is open source and free to use. View Quire's 3-clause BSD open source license.

Please note: Quire v1 is currently in a pre-release phase. Testing and improvements are ongoing.

Quire books feature:

To learn more about Quire, please visit our website which includes documentation, helpful resources, and information about how to get involved with the community.

Check out publications from the Quire community and some of Getty’s books developed with Quire.

If you’re considering using Quire for the first time, please be sure to visit our Implementation Considerations.

We encourage you to sign up for a free GitHub account to access the Quire Community Forum. You can utilize the forum to ask and answer questions, share ideas, provide feedback, and assist your fellow Quire users. Subscribe to our newsletter for the latest news and events, new feature updates, and highlights from our community.

Quire Repositories

There are three Quire repositories hosted on GitHub:

Installation and Usage for Quire

macOS

  1. Download and install the LTS version of Node.js: https://nodejs.org/en/download/.
  2. Install Quire with npm install --global @thegetty/quire-cli
  3. If you receive an error message that says "Error: EACCES: permission denied," run sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}. Then try step 2 again.
  4. Confirm installation with quire --version. You should see a version number that begins with a 1. If you receive the message "command not found" this means installation was unsuccessful.
  5. Vist the Get Started section of the documentation to begin a new Quire project.

Windows

  1. Download and install Git for Windows: https://gitforwindows.org/.
  2. Download and install the LTS version of Node.js: https://nodejs.org/en/download/.
  3. In PowerShell (Admin) install Quire with npm install --global @thegetty/quire-cli
  4. Once Quire has been installed, change your PowerShell permissions settings with Set-ExecutionPolicy -ExecutionPolicy Unrestricted.
  5. Confirm installation with quire --version. You should see a version number that begins with a 1. If you receive the message "command not found" this means installation was unsuccessful.
  6. Vist the Get Started section of the documentation to begin a new Quire project.

Dependencies

Quire is centered around the static-site generator Eleventy. The Quire command-line interface is written in JavaScript and requires Node.js LTS to run.

Either PrinceXML or Paged.js can be used for PDF generation.

Quire Commands 

Option Result
-V, --version Output the version number
-h, --help      Output usage information
Command Result
new \<projectName\> Create a new Quire project in the current directory
preview Run the preview server in the current directory
build Run the build command to generate the html site files
pdf             Output Quire project in PDF format (must run quire build first)
epub Output Quire project in EPUB format (must run quire build first)
clean Remove old build outputs

For more information about these commands please see the Quire Commands section of our documentation.

Contributing to Quire

There are many ways to contribute. No matter what level of experience you have, we welcome all contributions, big and small.

The first step to any contribution is to post a new issue or comment on an existing issue on our issue tracker. Please label your issues to the best of your abilities.

Possible contributions include:

Fix or Report a Bug

Improve Documentation

Translate the Documentation

Write an Article

Develop a New Feature or Theme

For more information visit our complete Contributing Guidelines

Thank you, Contributors

Thank you to our growing list of contributors who have made Quire what it is and are working on what it will be! They’ve participated in the forum, shared their projects, reported bugs, written/edited documentation, contributed code, and spoken about Quire at conferences.

Special acknowledgment is due to Eric Gardner (@egardner), who served as Digital Publications Developer at Getty from 2014 to 2018, and who conceived and spearheaded the original development of Quire. Thank you, Eric!

License

Copyright © 2022, J Paul Getty Trust.