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.

Sign up for GitHub

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

Jump to bottom

Convert FEA syntax document to markdown #772

Closed
miguelsousa opened this issue Mar 18, 2019 · 4 comments
Closed

Convert FEA syntax document to markdown #772

miguelsousa opened this issue Mar 18, 2019 · 4 comments
Assignees
@frankrolf
Labels
enhancement

Comments

@miguelsousa
Copy link
Member

Convert this document to markdown
https://github.com/adobe-type-tools/afdko/blob/develop/docs/OpenTypeFeatureFileSpecification.html
miguelsousa added a commit that referenced this issue Mar 22, 2019
@miguelsousa
Convert OpenType Feature File specification to Markdown (#777)
b54c897 
* Rename OpenTypeFeatureFileSpecification.html to .md (so changes are easier traceable)

* Automatic conversion to markdown

* Remove <pre> tags and **boldface** emphasis

* Create markdown-style headers

* Many manual edits:
fix quotes, apostrophes, re-format code examples, highlight keywords, etc.

* Unify formatting in dates

* Triple-backtick all code examples for formatting consistency

* Re-format list in the section
“An OpenType Layout engine’s layout algorithm”

* Update header and footer

* Fix formatting problems in section 9.
Improve keyword table in section 2.

* Fix formatting in section 8.

* Fix formatting in sections 6 & 7.

* Fix formatting in section 5.

* Use tabbing instead of triple quotes for code examples
Easier to read in the context of pure markdown.

* Add hard line wraps
Easier readability in raw markdown, won’t affect browser display

* Add more hard line wraps

* Improve keyword list

* Back to triple-backtick for code examples
(because it allows for syntax coloring)

* Fix formatting for section 4

* Finalize manual edits. Addresses #772

* Update README.md [skip ci]

* Make changes requested (as far as possible)
[skip ci]

* Fix double quotes example
[skip ci]

* trailing spaces

* Remaining requested changes [skip ci]

* Read's suggestions [skip ci]

#776 (comment)

* TOC: use unordered lists and hardcode the numbering [skip ci]
@miguelsousa
Copy link
Member Author

This is essentially done (see https://adobe-type-tools.github.io/afdko/OpenTypeFeatureFileSpecification.html), but syntax highlighting is not working.

I've added this snippet to Jekyll's config file, but it turns out Rouge doesn't support FEA yet.

@miguelsousa
Copy link
Member Author

Relevant discussion: https://git.luolix.topmunity/t5/GitHub-Pages/Syntax-highlighting-not-working-as-promised/td-p/7055

@miguelsousa
Copy link
Member Author

miguelsousa commented Mar 22, 2019 •
edited
Loading

GH documentation

@miguelsousa
Copy link
Member Author

Fixed via #777

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@frankrolf frankrolf

Labels
enhancement
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@frankrolf @miguelsousa