jser / jser.github.io

JSer.infoのブログリポジトリ

JSer.info

JSer.info のブログリポジトリです。

• Jekyll + GitHub Actions + GitHub Pagesで動いています
• 記事に対してtypo等の内容の修正をPull Requestできます
  • develop ブランチ(デフォルトブランチ)のMarkdownファイルに対して修正を送って下さい。
  • master ブランチのhtmlは自動的に生成されたファイルとなっています。
• 記事の元となるデータ等はjser/jser.infoで管理しています。

NOTE

JSer.info に関するIssueは以下のどちらに立てても問題ありません。

• jser/jser.github.io
• jser/jser.info

しいて分けるなら、以下のような感じです。

• jser/jser.github.io はサイトそのものについて
• jser/jser.info はその他全般

JSer.infoのSlackワークスペースは次のURLから参加できます。 JSer.infoに関する質問を気軽にしていただいて大丈夫です。

JSer.info Slack

Installation

# テストやJavaScript関係
npm install
# Jekyllのインストールとビルド
bundle install

Usage

Jekyllのビルド

bundle exec jekyll build

Tests

npm test

Deploy

• developブランチにマージすると自動でデプロイされます
• 手動の場合は次のコマンドでデプロイできます

bundle exec jekyll build
npm run build
npx gh-pages -d _site --branch master --no-history

Contributing

サイト記事上部の Edit on GitHub 又は 下部の この記事へ修正リクエストをする から修正を送れます。

記事からGitHubで直接編集してpull requestを送ることが出来ます。

ちょっとした誤字脱字でもご気軽に修正を送ってくださると助かります。 詳しくはCONTRIBUTING.mdを読んでみるといいです。

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

License

• _post/* : CC-BY
• Other: MIT

jser.github.io's Issues

「JSer.infoについて」ページ韓国語に翻訳。

リンク 'のエスケープは不要

O'Reilly Media
となってしまう

Markdownで書かれたリンクの生成方法について、いくつか改善した方が良い問題がある

特に「harmony:specification_drafts」のリンク(参考)で目立っているのですが、テキストとしてのURLに含まれるアンダースコア(_)がバックスラッシュ()でエスケープされていない為、該当の部分がイタリック体で表示されてしまっているという問題があります。

逆に、リンクのタイトルではバックスラッシュによるエスケープは必要ないようで、リンクのタイトルに関するツールチップの表示時にバックスラッシュが表示されてしまうという問題もあります。こちらの問題ではアンダースコアだけでなくブラケット([])も対象となっているようです。

リンクとしてのURLに関してはエスケープは必要ないはずですから、この辺りの問題をうまく解決するように、Markdownで書かれたリンクの生成方法を改善できると良いですね。

Twitterボタンを各リンクに表示する

経験則だけど、サイト上のTweetボタンを使う人が結構いる気がする(逆にないとTwitterへ投稿しない)
というのがある。
そのため、Tweetボタンやzenback見たいのは無意味ではないと考えてる。

JSer.info の場合、記事を紹介する訳だがJSer.infoの記事 ではなく 紹介先の記事 をブクマしてもらいたいというのを考えると、紹介先にTweetボタンがない(というか場所が安定しない)ケースも多いと思う。
(はてブ使ってる人はブックマークレットとか拡張とか使ってるのであんまり考慮する必要ない印象)

なので、JSer.info側にそのサイトのTwitterボタンを載せてしまうとかはどうなんだろ?
(Tweet数のカウントも少しは見る基準になるかもしれないし)

Circle CIとTravis CIで並列化

JekyllはTravis CI
Node系はCirCle CI
それぞれ分離する。

Lint用のGitHubアカウントの取得

token自分のを使うと、自分がコメントするので通知来ないという問題があるので、それ用のアカウントをとって使うようにする。

「2014-11-25のJS」の「Chrome 39 Beta」について

数日前に安定版としてChrome 39がリリースされました。Beta版としてリリースされたのはChrome 40です。
「2014-11-25のJS」は「2014-10-14のJS」のように修正した方が良いかもしれません。

Slackへのリンクや案内を追加する

https://join.slack.com/t/jserinfo/shared_invite/zt-g2shzp7o-f_tj6OaphCAFw5Qlt2Jw0A

• 記事の紹介のリンクもSlackに変える
• SupportのところのgitterをSlackに変える

タグの推論

• PRのタイトル
• 内容

からタグを推論して入れたい。

これができれば、ファイルを編集する必要がなくなる

feedly のアイコンをマウスホバーしてもハイライトされない

JSer.info のサイトのサイドバーにある Twitter、GitHub、RSS Feed のアイコンはマウスをあてると色が薄くなるのですが、feedly のアイコンは変化しないようになっています。

Autotrackの導入

• analytics.js 向け Autotrack のご紹介 - Google Developers Japan

たしか自分で同じようなのをやってた気がするので乗り換える

モバイルでのサイズ調整

モバイルだと、もう少しタイトルを小さくして、URLをでかくしたほうがよさそう。
誤爆するタップがありそう(関連記事)

Support Multiple Languages

JSer.info support i18n.

e,g.) http://jser.info/kr/

• Introduce Multiple Languages in Jekyll
• Check i18n template
  • Link, RSS, SNS button?
• Add Collaborators ( https://github.com/orgs/jser/teams/contributors )
• Setup CI for auto deploy(Default branch is master, Travis CI deploy to gh-pages)
  • Curently, rely on Github's Jekyll.
  • if use external jekyll plugin like Multiple Languages in Jekyll, have to build by hand or CI.
  • Continuous Integration
  • jirutka/rake-jekyll

PRのbodyを記事のヘッドラインにする

更新する際に

1. 記事のMarkdownを開く
2. エディタにコピーして編集
3. マージ

ということをやっているので、

1. PRのbodyを編集
2. 記事のヘッドラインとしてMarkdownに追加
3. マージ

というフローができるようにしたい。

結局エディタにコピーして編集しているので、PR上でそのまま更新できるようにするとよさそう
#802

PRを更新したときにtextlintが走らない

CIでmarkdownを更新してるので、
CIが反応してない可能性がありそう

リクエスト受け入れ口の導線

Pull Requestできるの知らない人が殆どだと思うので、
導線的なものを表示したい

CONTRIBUTING内のPull Requestのリンクが切れている

CONTRIBUTIONG.md内にあるPRのリンクが切れているようです。
master, develop, jser-week-337いずれのブランチのCONTRIBUTING.mdでも確認できました。

Chromeで確認すると次のように表示されます。

遷移先では次のようなエラーが表示されます。

Error Fetching Resource

Lint: Category Checker

Categoryの記述忘れをCIでチェックする

• Collect md files
• YAMLパース
• Lint

descriptionが重複している

• meta: descriptionがそもそもない
• descriptionの内容が重複してる

descriptionの重複ってどうやって回避するのがいいんだろ?
bodyのちょっとだけ取るとかかな?

モバイルで崩れる

https://github.com/jser/jser.github.io/blob/master/public/css/core/_normalize-post-content.scss

iframeがあると崩れる。
これの汎用的な方法ないのかな?

We’ve detected the file has mixed line endings. When you commit changes we will normalize them to Windows-style (CRLF).

Action経由で更新すると改行が混ざっている。

Circle CIの無効化

とりあえずCircle CI2が辛いので無効化した。
再度Circle CI 2を使うか、Travisに統合するかをする。

元々Travisでやってなかったのは、git cloneがshallowでdiffが上手く行かないパターンがあったからだったはず。でも今はreviewdog使ってるし、いけるはず。

GitHub Pagesにデプロイできない

• Unexpected Git error on GitHub Actions: RPC failed; HTTP 408 curl 18 HTTP/2 · community · Discussion #55820
  • The deployment occasionally silently fails · Issue #64 · jeffreytse/jekyll-deploy-action
• helaili/jekyll-action: A GitHub Action to publish Jekyll based content as a GitHub Pages site

CIからpushが失敗する。
ローカルで回避している

bundle exec jekyll build
npx gh-pages -d _site --branch master --no-history

probotが動いてない

https://github.com/jser/probot-jser-info

なんか反応がない

関連記事が動いてない

naturalのアップデートが問題っぽい

add lang([lang="ja"]) attribute in html tag.

jser.github.io/_layouts/default.html

Line 2 in 7009ffd

<html>

I use Google Translator because I don't know Japanese,
but the translator translates the page into English. I think lang attribute will help translator recognize it as a Japanese page.

(I am not Japanese but I like jser)

Convert: 過去のJSONからHTMLを取り除く

#136 で過去の記事のHTMLがあると邪魔っぽい。
なのでMarkdownに置換したい

2019-12-31-ember-3.15-octanetypescriptlibrary.md中のlinkが間違っています。

- [React で簡単に遅延読み込みを実装できるライブラリを作りました - 陽気なサイとエクストリーム！](http://example.com/ "React で簡単に遅延読み込みを実装できるライブラリを作りました - 陽気なサイとエクストリーム！")

ごのlinkがexample.comで作成されています。

レビューコメントLintを有効化

#57 を作って、Saddlerも直ったので

https://github.com/jser/jser.github.io/blob/develop/test/travis-spellcheck.sh
を有効化する

Draftスクリプトが壊れている

naturalがエラーを吐いている

Twitterに更新を通知できない

• Updates to IFTTT free tier - IFTTT

IFTTTのTwitter連携が2023-05-23で利用できなくなるので、https://twitter.com/jser_info にRSSを投稿するのが動かなくなる。

TODO

• 代替方法を探す

Draftをマージしたときに、URLをコメントする

mergeで、branch名? markdownからマージされた記事のURLをコメントする

文の間の改行が半角スペースになっている

これは以前からある問題でしたが、Markdown の仕様により、Markdown で書かれた記事における文の間の 1 つの改行が、最終的な記事上では改行として反映されず半角スペースになってしまっています。

2 つの改行を入れるとパラグラフとして文同士が離れてしまう為、Markdown で書く場合は改行とともに文末に 2 つの半角スペースを入れると良いのですが、GitHub と同じように、Markdown を HTML に変換する時に何らかの方法で現状でもうまく改行が反映できると良さそうですね。
あるいは、改行としても半角スペースとしても反映せずに、何も挿入されないようにするのも良いかもしれません。

probotが動いていない

GitHub Actionsに移行するのがいいのかも。(probotデバッグもしにくいから)

textlintの有効化

#457 のためtextlintが無効化されてる。

ES2016で入る機能/入らない機能をまとめる

• http://www.2ality.com/2016/01/ecmascript-2016.html
• http://ecmascript-daily.github.io/

ES2016に入る機能とはいらない機能が決まったのでまとめおきたい

Lint: Add file name lint

2015/2015-08-03-title.md is bad

/ko/ 以下はタイトルのチェックを入れる

    /ko/ 以下はタイトルのチェックをCIに入れるのが良さそうですね。

Originally posted by @azu in #1026 (comment)

TODO

• /ko/ 以下のファイルのtitleに日本語が混じってないかをチェックするスクリプトを書く
• GitHub Actionsで path:/ko/**/*.md の変更に対してスクリプトを回す

Another Option:

• コピーしたときに自動的に日本語を取り除くのJSと 、 → ,

ニーズ別の読み方の提供

初見でサイト見た時にどうやって読めばいいのかなーというのが分かりにくい気がする。

今読むものとして色々なパターンがあるので、トップページにそれの案内をぱっと見で分かるような形にしたい気がする。

• JSer.info
  JSer.info (@jser_info) | Twitter
• Realtime JSer.info
• ECMAScript Daily

後、ECMAScript Dailyだとメルマガも置いてるけど人によっては結構登録するっぽい印象がある。

後追加するならOneSignal - Multi-platform Push Notification Serviceとかを使ったプッシュ通知などがありえそう。

デフォルトリンクをタブで開くようにする

記事のリンクをデフォルトでタブで開くように_blank設定すると良さそうな気がする。
<base />タグで出来たような気がするけどどうだっけ?

辞書をproofdictに変更

https://github.com/proofdict/proofdict に統一する

記事の「Edit on GitHub」や「編集履歴を見る」のリンクが一部パーセントエンコードされている

記事の「Edit on GitHub」からPull Requestしようとした時に気付いたのですが、「Edit on GitHub」や「編集履歴を見る」のリンクが一部(「2014」の周辺)パーセントエンコードされているようです。

これが原因かは定かではないのですが、「Edit on GitHub」からアクセスした時に、すぐに記事を編集できる状態にはなりませんでした。

ただし、Pull Requestした後にアクセスしてみたところ正常に編集できる状態になっていたので、Forkに時間がかかっていただけなのかもしれません(Pull Request自体はパーセントエンコードされていないGitHub上のリンクからアクセスして行いました)。

all in one: 逆順

全てをまとめたall.jsonのitemは最新が先頭であった方がよさそう

fix textlint filter rule

ignore node-type is deprecated

Lint: Author & Translator Check

check author and translator of article meta filed.

• author must
• translator is optional, but articles that are under the ko/ have to have.

https

should be full https

7/28 のpermalinkがつけ忘れ(?)で `2015/07/28/title/`になっている

https://github.com/jser/jser.github.io/blob/develop/_i18n/ja/_posts/2015/2015-07-28-title.md

http://jser.info/2015/07/28/title/

titleでも影響はないけど。