GitHubで講義ノートを書く
はじめに 大学の講義ノートをいくつかGitHubで公開しています。 講義ノートをMarkdownで書いてGitHubで公開、というのをしばらく続けて、いろいろノウハウが溜まったので共有してみようと思います。 大学の講義ノートをどうするか問題 昔から大学の講義ノートを公開する人は結構多いです。最初期は、LaTeXで書いてPDFで公開することが多かったように思います。これはこれで良いのですが、基本的にはダウンロードして印刷して読む前提であり、ウェブで気軽に読める形ではありませんでした。その後、LaTeX2HTMLを使って、LaTeXファイルをHTMLに変換して公開するケースが増えました。これによりウェブで講義ノートが気軽に閲覧できるようになったのですが、いかにも「LaTeX2HTMLを使って変換しました」という外観になるのと、(少なくともデフォルトでは)レスポンシブではなく、スマホ非対応になる
自作 Markdown プロセッサベースの blog.jxck.io v2 リリース | blog.jxck.io
Intro 本サイトは自作の Markdown ビルダを使っていたが、色々と気に食わない部分があったのでフルスクラッチで作り直し、それにともなってサイトの刷新を実施した。 必要だった要件や、意思決定を作業ログとして記す。 Markdown 本サイトは、一般に使われている Markdown -> HTML の変換結果では要件を満たせないため、最も都合の良い AST を吐く Kramdown のパーサから AST だけを取得し、それを Traverser でカスタマイズしてから自前でシリアライズしていた。 その実装を、微修正を繰り返しながら、継ぎ足し継ぎ足しで 5 年くらいイジってきたので、そろそろ自分がブログを書く上での要件も固まっており、記事中の Markdown のスタイルも固定してきた。 一方、 Kramdown の実装が原因でどうしてもワークアラウンドが必要だった部分に、フラストレー
macOSのメモからMarkdownを作るショートカット - cockscomblog?
macOS Montereyから、「メモ」アプリに「クイックメモ」という機能がついた。 インターネットブラウジングをしていて気になったことを書きつけていくのにちょうどよさそうなので、使ってみることにする。ある事柄に関連するリンクをひとつのメモに連ねていって、ちょっとテキストで補足を書いておく。 これをブログで手軽に共有できたら、なおいい。Markdown形式に変換したい。 メモの本文を取得する メモの内容を取得するには、Apple Script的なやつを使う。ここではJXA (JavaScript for Automation)というので、JavaScriptっぽく書く。選択中のノートの本文を得るには、次のようにする。 const app = Application("Notes"); console.log(app.selection()[0].body()); これでノート本文がHTM
行政文書をマークダウン化しよう！ところでマークダウンって何？｜METI-DX 経済産業省DXオフィス
最初に見つけたのがこのユーザー会さんのページです。こちらにマークダウンとは「文章の書き方」とあります。なるほど簡単。軽量マークアップ言語よりは、かなり柔らかくなりました。ただ、むしろ簡単になりすぎて今度は具体的なイメージが沸かないか？ 次に見つけたのは、こちらのブログです。 ここでは、「手軽にドキュメントを装飾できるフォーマット」とあります。うんうん、なんとなくイメージしている説明に近づいてきました。 そして最後に見つけたのが https://wa3.i-3-i.info/word16753.html 単なる「ファイルの書き方ルールの１つ」ですよと。これですかね。 人間社会に「日本語」「英語」「ドイツ語」などの様々な言語があるように、デジタル世界でも、HTMLとかXMLとかPDFとか、いろいろな言語(ファイルの書き方ルール)がある、そのうちの１つがマークダウンという言語。それ以上でも以下で
自己流の手順書フォーマットを公開してみた | DevelopersIO
手順書フォーマットは千差万別 みなさんは自己流または、組織やプロジェクトで定められた手順書のフォーマットはありますか? 私は自己流の手順書フォーマットがあります。 自己流の手順書フォーマットがあるといっても、かなり扱いがふわふわしているので、備忘やメモの意味合い強めでまとめていきます。 「もっとこうした方がいいよ!!」などフィードバックがあれば、ぜひお願いします! いきなりまとめ 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書はgitで管理する 5W1Hを意識して手順書を書く 基本的にはCLIを使った手順書にする 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書をExcelやスプレッドシートで書くメリット・デメリット 手順書をExcelやスプレッドシートで書いている方も多いと思いますが、私はMarkdownで書いています。 Exce
Markdownでスライドを作るツールのFusumaのv2をリリースをしました - 技術探し
リポジトリ: github.com 今回の変更では、面倒事を減らしスライド作成に集中できるようにすることを目標にしていました。 Fusumaとは？ #0CJS MDX(Markdown + JSX(optional)) を使いスライドを作れる プレゼンターモードの提供(なぜかTwitter流せたりや落書きもできる) 音声録音とスライドの操作記録を保存できる github pagesへのデプロイがメインで、pdfでも出力可能 大きな変更 og:imageを自動生成/設定するようにしました ogp用に画像を設定するのがめんどくさいという意見があり、自動的に生成するように追加しました。現在はスライドの1ページ目を画像化しています。 ユーザー側へCSS Variablesを提供しました v1では、publicで外に出さずに自由にcssを書いてもらうようにしていましたが、0から書くのはめんどくさい部
node modules なし blog を作っている話 | maxmellon's blog
node modules なし blog を作っている話今年の9月頃から，no dependencies で blog を作っています．(devDependencies には，jest と TypeScript を入れています) 正直，フレームワークを使えば blog くらいならすぐ作れるだろうと思っていたのと， フレームワークの使い方を覚えることが自分の成長に大きくつながるとは感じることができず， やっていて楽しい + 学習する余地がありそうな no dependencies で blog を作ることにしました． リポジトリはこちらです maxmellon/kajitsu 機能要件を考えるざっくり，自分がほしいなと思った要件を整理すると， markdown で記事を書きたいblog だけじゃなくて cookie や Cache-Controll header などを検証できる sandb
Puppeteer で静的サイトの Font Subsetting | blog.jxck.io
Intro Web Font のサブセット化を Font Weight に応じて作り分けるとともに、それを Puppeteer を用いて生成するように変更した。 Web Font の静的サブセット 本サイトで提供している Web Font は当初、文字を事前に選定して生成したものを使っていた。 Noto Sans の Web Font 対応とサブセットによる最適化 当時はコンテンツがなかったが、コンテンツも増えた後は、コンテンツの原稿である markdown ファイルから使用している文字を抽出して生成するように変更していた。 これでおおよそ必要最小限のサイズにすることができていた。 Regular と Bold の最適化 本サイトでは Font Weight として Regular(400) と Bold(700) を提供しているが、これまでは抽出した文字種を Bold/Regular 両
Electron製アプリの起動速度を1,000ミリ秒速くする方法
めっちゃダッシュするイヌさん英語で先に書いてから日本語訳しています ⇒ English version is available here. こんにちは、TAKUYAと申します。InkdropというMarkdownノートアプリを開発しています。このアプリはElectronで作っています。Electronは、NodeJSとChromium(ブラウザ)ベースでクロスプラットフォームなデスクトップアプリが開発できるフレームワークです。このフレームワークは基本的に素晴らしいです。なぜならあなたはネイティブ用のフレームワークを学ぶ必要がなく、JavaScript、HTMLとCSSでアプリが作れるからです。もしあなたがウェブデベロッパーだったら、手軽にアプリが作れるでしょう。一方で、多くの人がElectronの弱い点についても言及しています。それはアプリの起動速度が遅い傾向にある、という点です。僕のア
Markdownベースのプレゼンテーション・エディタ「Slideas for Mac」が、次期アップデートで「reveal.js」フレームワークをサポートしHTML形式での書き出しが可能に。
Markdownベースのプレゼンテーション・エディタ「Slideas for Mac」が、次期アップデートでプレゼンテーション・フレームワーク「reveal.js」のテーマと、HTMLエクスポートをサポートするそうです。詳細は以下から。 SlideasはフランスのAgaric Perdereauさんが開発しているMac用のプレゼンテーション・エディタで、Markdown記法でプレゼンテーションを作成できますが、このSlideasが次期v1.2アップデートでHTMLプレゼンテーション・フレームワーク「reveal.js」をサポートするそうです。 I also had multiple requests for a simple Slide Template. I then decided to port some of the Reveal.js themes to Slideas.[…]T
Please don't write your documentation in Markdown
March 23, 2020 Please don't write your documentation in Markdown Please don't write your documentation in Markdown. Please. I'm begging you. Markdown is tolerable for short documentation, like a readme.md. Past that, it's the wrong tool for the job. Markdown is about formatting, not information Markdown is just a way to write simpler, nice looking HTML. There is direct mapping between _foo_ and <e
44種類のフォーマットに対応したPandocでMarkdownをHTML形式に変換する | DevelopersIO
今回紹介するMarkdownやHTMLは当然として、reStructuredText、Textile、LaTeX、何故かCSV，EPUB、docx（Word）や、pptx（PowerPoint）、Jupyter notebook、各種Wiki形式、PDFに対応しています。 魅力②「メタデータや独自フォーマットへの豊富な対応」 Pandocは、Markdownのシンタックス拡張や、ドキュメントメタデータ、テーブル、脚注、箇条書き、上付き文字、下付き文字、順序付きリストに対応しています。文書変換時に、このあたりのフォーマット情報がきちんと変換されるのは心強い。 魅力③「定期的なアップデート」 Pandoc - Releasesを見るとわかりますが、ほぼ3ヶ月に一度ほど定期的に更新されています。最新のリリースは2020年2月15日と非常にフレッシュ！ 自分実はPandoc自体は3年ぐらい前からそ
クロスプラットフォームに対応したオープンソースのノートアプリ「Notable」がHTML/MarkdownでのエクスポートやSplitViewモードに対応。
クロスプラットフォームに対応したオープンソースのノートアプリ「Notable」がHTML/MarkdownでのエクスポートやSplitViewモードに対応しています。詳細は以下から。 Notableはイタリア・カターニア大学のFabio Spampinatoさんが2018年12月に公開したオープンソースのノートアプリで、Joplinのように脱Evernoteユーザー向けにノート(.md)と添付ファイルを分離して管理するディレクトリ構造やファジー検索、タグのネスト化などがサポートされていますが、このNotableがv1.2.0アップデートでHTMLおよびMarkdown, PDFでのエクスポート機能をサポートしています。 また、Notable v1.2.0ではエディタエリアとプレビューエリアの両方を表示するSplit-Viewモードやファイルの自動保存機能、メタデータへの作成日と変更日保存、
一瞬でExcelの表をHTML形式やMarkdown形式に変換する方法 - プロクラシスト
Markdown形式で一番面倒だなと思うのが表の作成です。 こればっかりは、Excelでいろいろと編集したほうが楽そうです。 つまり、Excelでの編集結果をmarkdownに変換できれば良いわけです。 今回、そんなMarkdow使いにとって夢のようなツールを紹介します Tables Generator 使い方(簡略版) 使い方(詳しく:注意とtips有り) 参考:セルの結合をしたいときはHTMLで まとめ Tables Generator www.tablesgenerator.com 一瞬でMarkdownのテーブル形式に変換してくれる、ウェブサービス。もちろん無料。 使い方(簡略版) 1. Excelで作成した表をコピー 2. Tables GeneratorのFile→Paste table data...をポチ 3. 変換されたデータのCopy to Clipboardをポチ た
markdownをHTMLにして他人に渡すベストシナリオを求めて - Qiita
markdownで作ったドキュメントを他人に渡したい エンジニア同士ならまだしも、非エンジニアにmarkdownを渡すときって、いろいろ大変 プレーンテキストがUTF8なのかSJISなのかの相場が今は収束してない .mdという拡張子にオーソライズされた認識がない シンタックスハイライトとかtableとかは、プレビュー環境によってばらつく （特にtable） じゃぁHTMLにしたものを渡せばいいじゃない ところが、プレーンなHTMLに変換してくれるいいツールがない githubみたいなところで、.mdを見てもらうという方法もあるが、みんながgithubのアカウントをもってるわけではない HTMLに変換するツールは結局CSSへの外部リンクがあって、社内ドキュメントから外部への通信をさせたくない 複数ファイルをzip圧縮すると、Windowsのzipフォルダは、直接CSSを参照できない Mark
Vim でコンテキストによって filetype を自動的に切り換えるプラグインをつくっている - C++でゲームプログラミング
この記事は Vim Advent Calendar 2012 194日目の記事になります。 例えば、html では <script type="text/javascript"> console.log("Hello, JavaScript") </script> 例えば、markdown では ```vim echo "hello, vim" ``` ```ruby echo "hello, ruby" ``` 例えば、Vim では python << EOF print map(str, range(1, 10)) print "-".join(map(str, range(1, 10))) for value in range(1, 10): print "mami%d" % value EOF ruby << EOF result = (1..10).map(&:to_s).joi
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
sakedrink.info
フロントエンドエンジニア（仮） 〜え、ちょっとフロントやること多すぎじゃない！？〜