Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Define Article structure #1

Open
flipactual opened this issue Apr 28, 2016 · 1 comment
Open

Define Article structure #1

flipactual opened this issue Apr 28, 2016 · 1 comment
Assignees

Comments

@flipactual
Copy link
Collaborator

Both how structures are described in MANIFEST.ymls and formatting within the markdown files.

@wayspurrchen
Copy link

For issue 1, I've decided to keep it simple and go way lo-fi.

Pages

For the first issue, let's use a simple "page" abstraction. A page is a markdown file that is optionally preceded by YAML front-matter (I'm assuming remarked / whatever we're using can parse this - if not, I have tooling that can parse and strip front-matter hanging around, so let me know). There will not be any page length measuring so we will have to manually make sure that each file's content does not exceed the length of a regular page. Otherwise, the markdown file can include arbitrary HTML for formatting on a per-page basis. This will be fairly manual, but we'll keep issue 1 simple and short. Eventually, we should probably settle on a list of design elements, and the classes used to style those.

MANIFEST.yml

The MANIFEST.yml will probably not change at all.

Expected "Dressings"

Most of the work will come in the different renderers' derived metadata from the page or MANIFEST.yml. At the moment, the only thing I see this being is attaching page number metadata to each page's representation in whatever rac-pub mode, and then setting up a base template that the page is then rendered into.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants