reubenlillie / epellyson Goto Github PK

A Hugo theme for the electronic Manual of the Church of the Nazarene

License: MIT License

HTML 75.53% JavaScript 24.47%

church church-administration hugo hugo-theme nazarene manual publishing static-site-generator vanilla-javascript vanilla-js functional-js functional-programming

epellyson's Introduction

E. P. Ellyson

E. P. Ellyson is a Hugo theme built with HTML5, CSS, and Vanilla JavaScript.

Named after Edgar Painter Ellyson (1869–1954), the third general superintendent of the Church of the Nazarene, this theme is designed to showcase electronic editions of the Manual of the Church of the Nazarene.

The E. P. Ellyson theme is meant to be lightweight and user-friendly. The theme is made as modular as possible to prioritize effecient delivery over connections with limited bandwidth and on smaller screens.

Installation

This theme is a submodule to the main site repository. If you have already installed the main repository locally, then there is no need to install the this theme separately.

However, if you wish to test this theme with a different Hugo project:

Follow instructions to install Hugo locally.
Add this theme as a submodule

$ git submodule add https://github.com/reubenlillie/epellyson themes/epellyson

Contributing

All issues and pull requests are welcome. Ask questions. Correct typos.

If you code, that’s great!

If you don’t, then please help us improve our documentation and other text files.

Check out our wiki and contributing guidelines for more information.

epellyson's People

Contributors

Stargazers

Watchers

epellyson's Issues

Add menu toggles

Create toggle function for nested table of contents menu in the header/sidebar.

Create subdirectories for partial templates

Add subdirectories to /layouts/partials/ for

Head
Header
Aside
Footer

Then update file path references in template files inside the /layouts/_default/ directory and elsewhere.

For more information about Hugo partial templates, see https://gohugo.io/templates/partials/.

Number content with JavaScript, not CSS

Create JavaScript for numbering
- Parts
- Chapters
- Articles
- Paragraphs, and subparagraps
Convert CSS counters to fallback feature when JS is deactivated

CSS content: value; declarations are not a part of the DOM. They are only rendered visually. Counters cannot be selected with a cursor, and they are not detectable by screen readers. JavaScript should replace counters by injecting <span> and <a> with insertAdjacentHTML('afterbegin', counter) to number subheads and paragraph/subparagraph <section>

Dynamically load publication information

Retrieve copyright page information with AJAX from the main site repository.

Add links for Bible references

Scan text and dynamically add links to scripture references.

Should these links be to onsite content, like a /content/scripture-references/ directory with version and copyright permissions?

Or should these links be to a third-party API? If so, which one?

The inline CSS in /layouts/partials/head.html is experimental right now. It needs to be separated into smaller files and placed in an /assets/css/ directory to be linked with bundling, minification, and fingerprint caching. For more information on Hugo asset management, see https://gohugo.io/categories/asset-management.

Organize /layouts/partials/ directory

Break /layouts/partials/ directory into smaller subdirectories based on containing DOM element:

head
header
aside
footer