jser / jser.github.io Goto Github PK

check author and translator of article meta filed.

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

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

更新する際に

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

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

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

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

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

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

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

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

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)

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

• Collect md files
• YAMLパース
• Lint

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

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

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

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

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

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

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

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

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

should be full https

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

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

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

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

Originally posted by @azu in #1026 (comment)

TODO

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

Another Option:

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

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

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

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

Error Fetching Resource

• 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

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

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

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

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

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

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

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

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

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

なんか反応がない

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

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

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

• PRのタイトル
• 内容

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

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

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

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

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

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

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

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

ignore node-type is deprecated

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

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

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

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

• Updates to IFTTT free tier - IFTTT

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

TODO

• 代替方法を探す

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

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

naturalがエラーを吐いている

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

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

O'Reilly Media
となってしまう

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

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

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

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

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

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でも影響はないけど。

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

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

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

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