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

仕様の参照の仕方を統一する #165

Closed
bakera opened this issue Jul 26, 2021 · 5 comments
Closed

仕様の参照の仕方を統一する #165

bakera opened this issue Jul 26, 2021 · 5 comments
Labels

Comments

@bakera
Copy link
Owner

bakera commented Jul 26, 2021

仕様の参照、特に仕様の途中箇所を参照している箇所について、参照の仕方を検討・統一する。
たとえば以下のようなもの。

HTML Living Standard 4.4.4 The blockquote element 1

仕様名・セクション名をフルで書くのか、文中に何を残して何を脚注に入れるのか、など。

Footnotes

  1. https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element

@momdo
Copy link
Collaborator

momdo commented Oct 6, 2021

全部列挙して調整になりますかね…?

@momdo momdo assigned momdo and unassigned momdo Oct 7, 2021
@momdo
Copy link
Collaborator

momdo commented Oct 9, 2021

Editor's Draftを参照するのか、TRを参照するのかもブレている(ルールに基づいて一貫していない)

@momdo
Copy link
Collaborator

momdo commented Oct 13, 2021

HTML Standardの参照に当たっては、#218 で触れているように、その性質上section番号がずれる。

どこかで2021-yy-dd時点でのHTML Standard(仕様)を参照しています、みたいな一文の断り書きを入れておく。

その上でいくつか選択肢があると思っていて、

section番号だけにするのか、section名もあわせて入れるか、例えば

  • HTML仕様4.4.4を参照1
  • HTML仕様4.4.4 The blockquote elementを参照1

のいずれかにする。あるいは、脚注に押し込める、例えば

  • HTML仕様を参照2
  • HTML仕様を参照3

のようにするのか。

Footnotes

  1. https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element 2

  2. HTML 4.4.4 https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element

  3. HTML 4.4.4 The blockquote element https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element

@kyokoseki
Copy link

レイアウト上では側柱のmemoとして以下のようにしています
基本的に、このように揃えていますが、イレギュラーもあります。
基本的に、sectionがあればわかると思います。
側柱は一行の文字数が少ないので、あまり長いと折り返しで読みづらくなるので。

4.4.4 The blockquote element
https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element

@momdo
Copy link
Collaborator

momdo commented Oct 21, 2021

なるほど、ありがとうございます。

その線で修正を試みてみます。

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

No branches or pull requests

3 participants