garrettmills/www
1
0
Fork 0
Code Issues Pull Requests Releases Activity

Update MarkMark spec to include optional dates

Browse Source
This commit is contained in:
Garrett Mills 2024-12-31 12:00:12 -05:00
parent a37037a693
commit 5535c419be
3 changed files with 22 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
src/app/http/controllers/MarkMark.controller.ts
View File

@ -12,7 +12,7 @@ export class MarkMark extends Controller {
const home = <Home> this.make(Home)
return view('markmark:welcome', {
...home.getThemeCSS(),
title: 'MarkMark (v1.0)',
title: 'MarkMark (v1.1)',
})
}
@ -28,7 +28,7 @@ export class MarkMark extends Controller {
const home = <Home> this.make(Home)
return view('markmark:standard', {
...home.getThemeCSS(),
title: 'Spec: MarkMark (v1.0)',
title: 'Spec: MarkMark (v1.1)',
contentHtml: this.cachedStandard,
})
}

19
src/app/resources/markmark/standard.md
View File

@ -1,4 +1,4 @@
# Standard MarkMark (v1.0)
# Standard MarkMark (v1.1)
**MarkMark is an extremely simple, standard, plain-text format for collecting bookmarks in such a way that they can be shared and federated.**
@ -82,11 +82,13 @@ This is a description of the Technical Blogs section in my MarkMark file.
```text
LINK :=
- STRING TAGS\nINDENT HREFS
- STRING DATE TAGS\nINDENT HREFS
DATE := (ISO8601) | EOL
TAGS :=
TAG TAGS
| EOF
| EOL
TAG := #SLUG
@ -101,6 +103,12 @@ Links are individual entries in a bookmark collection and represent a bookmark t
A link is a Markdown Bullet List item (CommonMark §5.2) with a sub-list of URLs. Each URL MUST be either a plain-text URL OR a Markdown Link (CommonMark §6.3). Markdown Link URLs MUST use the URL as the only text for the link.
#### Dates (v1.1)
Each link MAY have one date associated with it. The date associated with a link SHOULD refer to the date the link was accessed by the author and added to the collection. The date MAY refer to the publication date of the associated media.
Dates MUST be in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Calendar_dates) format and MUST minimally include the year, month, and day.
#### Tags
Each link MAY have one or more tags associated with it. Tags provide an additional organizational scheme as they can be used to associate links across sections.
@ -145,3 +153,8 @@ Here is a collection of personal blogs and homepages from members of the Doe fam
[Standard MarkMark](https://garrettmills.dev/markmark) by [Garrett Mills](https://garrettmills.dev/) is marked with [CC0 1.0 Universal](http://creativecommons.org/publicdomain/zero/1.0?ref=chooser-v1).
## Change Log
- `v1.1`: Added spec for optional dates
- `v1.0`: Initial Standard

5
src/app/resources/views/markmark/welcome.pug
View File

@ -14,7 +14,7 @@ block content
section#main
img.markmark-mark(src=asset(textIsLight ? 'markmark-light.svg' : 'markmark-dark.svg') alt="MarkMark Logo")
h2(style='font-size: 40pt') Standard MarkMark (v1.0)
h2(style='font-size: 40pt') Standard MarkMark (v1.1)
p MarkMark is a free (<a href="https://en.wikipedia.org/wiki/Free_as_in_Freedom" target="_blank">as in freedom</a>) bookmark format designed to be machine-readable and easy to use.
p The goal of MarkMark is to standardize "link sharing" pages to build connections between small websites on the Internet.
p You can view the full standard <a href="#{route('/markmark/standard')}">here</a>.
@ -39,6 +39,9 @@ block content
|
| - My Code
| - https://code.garrettmills.dev/garrettmills
|
| - Post: Mitigating CVE-2024-2961 (2024-04-22) #blog
| - https://garrettmills.dev/blog/2024/04/22/Mitigating-the-iconv-Vulnerability-for-PHP-CVE-2024-2961
h3 Resources
ul