@justfixnyc/contentful-common-strings
v0.1.4-alpha.0
Published
This module provides tooling for retrieving and displaying common rich-text content shared by JustFix.nyc projects.
Downloads
35
Readme
This module provides tooling for retrieving and displaying common rich-text content shared by JustFix.nyc projects.
Each common string has an alphanumeric id and a value. The value is a localizable
rich text value. For example, the original motiviation for this package is the common
string with id covidMoratoriumBanner
, which has a value containing the rich text
to show users about the current state of the COVID Moratorium, localized in both
English and Spanish.
This package contains tooling to retrieve all entries from a pre-configured Contentful space that have been given a particular tag. Each of these entries is expected to have a short text field called id
and a localized rich text field called value
.
These entries can be retrieved in one of two ways:
A command-line program called
contentful-common-strings
. This can be useful for static sites that want to have the entries rendered at build time.Via the
fetchContentfulCommonStrings
function, which can be run from node or the browser.
Functionality provided by the ContentfulCommonStrings
class makes it convenient to retrieve a common string's rich text document representation by its id. The front-end can then render them using a package like @contentful/rich-text-react-renderer
.
For an example of this package in use, see the manual test code.
To use the manual test, you can run yarn watch
and then visit http://localhost:8080/.