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

2019年度 第1回カリキュラムのtypoや修正点 #8

Open
5 tasks
sironekotoro opened this issue Mar 19, 2019 · 8 comments
Open
5 tasks

2019年度 第1回カリキュラムのtypoや修正点 #8

sironekotoro opened this issue Mar 19, 2019 · 8 comments

Comments

@sironekotoro
Copy link

sironekotoro commented Mar 19, 2019

  • 「端末」を「ターミナル」に寄せる
  • 「プログラム」と「スクリプト」を明確に分ける
  • 大事なところは強調をもっと使う
  • 強調のmarkdownを __ から ** に変更
  • スクリプト引用部の開始は perl や bash など引用するコードを明示する(revealup.js+ highlight.js 使用)
@sironekotoro
Copy link
Author

  • まずは第1回第1部から

  • 想定する最低年齢を小学校高学年と考えてルビを振る

  • 初出の重要用語、概念は強調する

  • 文中の句読点は「、」「。」で統一

  • リンクはmarkdownの別窓で開く記法が使えないので、直接aタグを使う

@sironekotoro
Copy link
Author

sironekotoro commented Sep 15, 2019

  • xtetsujiさんから提供してもらったワンライナー( Fix 2019 1st part1 #42 (comment) )で半角のカギ括弧を全角のものに置換する
    perl -p -i -e 's/「/「/g; s/」/」/g' 1st/part1.md

@xtetsuji
Copy link
Member

Reveal の Markdown の表現力や CSS次第かもしれませんが、bash の入力ブロックと Perl の入力ブロックの背景を変えるのもいいかなと思いました。

@sironekotoro
Copy link
Author

指摘で思い出したのですが、現状のコードハイライトが色覚異常でも区別がつくかの確認をどこかで入れたいと思ってます。

@sironekotoro
Copy link
Author

@xtetsuji
Copy link
Member

いわゆる msys2 の表記が(世間でも)揺れている部分が気になりました。

  • MSYS2 : 製品名?
  • msys2 : 上記のプログラム?

厳密な定義は無いかもしれませんが、その場合でもPerl入学式ではこういう意味で使うという統一的な方針は決めておきたいです。

@sironekotoro
Copy link
Author

これは「ゼロからわかるRuby超入門」なのですが、こんなふうに色分けできると確かにいいですね。
CSS力無いので、直接blockquoteタグ書くしかないのだろうか・・・

image

あと、画像をクリップボードからこの入力欄につけたらそのままアップロードされた。すごい。

@xtetsuji
Copy link
Member

Reveal を調べてみて

```perl
Perlコード
```

といった部分を perl 部分を見て色付けを変える方法があるか探ってみるのもがいいかもしれませんね。負担が大きそうなので、 @sironekotoro さんだけでなく、他の方に協力をお願いしてみたいところ。

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

No branches or pull requests

2 participants