静的サイトジェネレータ「Astro 2.1」リリース。画像の最適化、Markdocのサポート、ファイル変更検知し型チェックなど新機能
静的サイトジェネレータ「Astro 2.1」リリース。画像の最適化、Markdocのサポート、ファイル変更検知し型チェックなど新機能 オープンソースで開発されている静的サイトジェネレータ「Astro」の最新バージョンとなる「Astro 2.1」が正式にリリースされました。 Astro 2.1 is here with a brand new <Image> component! Check out the full release:https://t.co/tFxjU86eVR — Astro (@astrodotbuild) March 8, 2023 Astroは、ReactやVue、Svelte、Alpine.js、TypeScriptなどのさまざまなフレームワークやライブラリに対応した静的サイトジェネレータです。 ビルド時にWebサイト全体のHTMLが生成され、しかもそのHTMLに
MkDocs で生成したサイトをローカルで開くと index.html が開かれない問題 - stamemo
たとえば以下のような Markdown を書いてビルドしたとすると、 - [page1へのリンクです](pages/page1.md) 生成したサイトでは「page1へのリンクです」ハイパーリンクが表示され、これをクリックすると page1.md に相当する HTML ページにアクセスできるはずだ。 しかし実際の挙動は、 サイトの構造は pages/page1/index.html となっている リンクをクリックした時は pages/page1 という ディレクトリが開かれ、index.html まで開かれない となる。なぜなのか。 なぜ？ ディレクトリにアクセスした時に index.html を開く、という挙動はウェブサーバーが行っている から。ローカルから生成サイトのファイルにアクセスした場合、当然ならウェブサーバーは動いていないので、この挙動も働かない。 どうすれば開くようになる？
GitHub Flavored Markdown は何であって何でないか - Qiita
のんびりしていたらこんなメンションをもらっていたので、ちょっとまとめてみようと思います。 そろそろ @tk0miya さんがアップしてくる頃。GFMはspecかっちりしてるんでしたっけ(markdown全く詳しくない — Aki Ariga (@chezou) February 1, 2020 かっちりしている? この記事を読んでいる皆さんは Markdown の歴史に精通していると思うので、古い部分はざっくり割愛してしまいますが、オリジナルの Markdown は かっちりしていない ことで有名なマークアップ言語です。 必要最低限のマークアップ要素は規定されていて HTML への変換ツールも完成していた Markdown ですが、マークアップ言語の言語仕様としては貧弱で、インデントのルールやインライン要素をネストしたときの挙動、空行の有無による解釈の違い、などなど、細かい部分のルールにつ
Markdownで書籍を作るとは - golden-luckyの日記
昨日まで何回かにわたり、多様なドキュメント形式の変換アプリケーションであるPandocのコアとなる仕組みを説明してきました。 特に、Pandoc構造とそれを生成するReader、生成されたPandoc構造を変換するPandocフィルターについて、少し時間をかけて紹介しました。 では、PandocのReaderとフィルターについて理解したところで、Pandocを使って本は作れるでしょうか？ いままでの説明には登場しませんでしたが、Pandocの出力側を担うWriterには、「PDF生成のためのLaTeX Writer」や「EPUB Writer」など、「本」を作るのに使えそうなものがあります。 それらWriterを制御するためのコマンドラインオプションはいろいろ用意されており、独自のテンプレートを指定することも可能です。 ただ正直なところ、これらのWriterは、吊るしの状態では売り物の本を
マインドマップ徹底活用術
チーム開発の進め方 - クックパッド開発者ブログ こんにちは！クックパッド編集室メディア開発グループ長の @yoshiori です。 今回はウチのチームの開発の進め方や見積もりの仕方を説明しようと思います。 実はコレ系の話は 5 年前にもデブサミで発表 したのですがこの時はリリースまで 1 年とかのレベルのプロジェクトの進め方の話でした。今回は 1,2 ヶ月でリリースまで持っていく開発の進め方を説明します。 動画サービス部分を microservices 化するときに実際に行った事を元に説明します。開発者は 3 人で 1.5 ヶ月位の開発です。 何故このようなことを行うのか 誰だって楽しく仕事がしたいし、なるべく不安などは無い方が良いはずです… techlife.cookpad.com ↑に書いてあるような開発の進め方を前職でもやっていて、チームで集まって見積もりをするとき、最初はホワイト
プレーンテキスト Markdown 時代の終焉
なぜ Day One は Markdown を捨てたのか Day One が Markdown をやめて WYSIWYG に移行した話は前書いた。 Day One がクソになった Day One 、このブログでも度々言及していて、 Markdown で日記が書けて便利だったんだけど、最近のバージョンアップ（ Mac は 2.8 以降 、 iOS は 3.0 以降）でプレー... portalshit.net 自分が知っている範囲でアンチ Markdown 勢は Scrapbox くらいしか思い浮かばず、 GitHub や Trello などのグローバル勢に加え、 Qiita やはてなブログなど日本国内向けのサービスでも当然のように Markdown が共通言語として使われているのに、その Markdown を捨てて WYSIWYG 化する1という戦略は疑問だった。 ひとむかし前の WYSI
GitbookユーザはRust製mdBookを使うと幸せになれる、かも - Qiita
要約 mdBookはGitbookにインスパイアされてるRust製ドキュメントビルダー Rust製なのでぶっちぎりに速い、メモリとCPUに優しい 諸々足りない部分はあるが、ある程度運用でカバー出来る 履歴 2016.06.07 mermaid.jsの読み込みと図のレンダリングについての記述を追加 はじめに 社内のドキュメント整備を行うに当たり、まあどうせならバージョン管理しながらテストもしたいし、体系的に纏められるGitbookがいいよね、って話になりました。んで、既存のドキュメントなんかもGitbookにドンドン移行してました。 私は普段、エディターはAtomを利用し、gitbook serveコマンドでwatch & HotReloadをさせながら表示項目を確認しつつ、ツラツラと作成してました。 基本的には push->CI（ビルド&テスト）->デプロイ を繰り返す環境です。 ドキュメ
LaRecipe - Markdownから格好良いドキュメントを生成
MOONGIFTはオープンソース・ソフトウェアを紹介するブログです。2021年07月16日で更新停止しました 開発者に対して見栄えの良いドキュメントを提供する、これはDevRelにおいて大事な要素です。誰だって使いづらい、読みづらいドキュメントは嫌がるものです。デザインはもちろんのこと、文字サイズや見出しの付け方などによっても可読性は変わってきます。 そこで紹介したいのがLaRecipeです。Laravelを使い、Markdownから綺麗なドキュメントを生成してくれるソフトウェアです。 LaRecipeの使い方 デモです。左側に大見出し、中央がコンテンツ、右側にそのページのアウトラインが表示されます。 コードなども綺麗に表示されます。 アウトプットのデモデザインを入れている例。 ドキュメントの下にはコメント欄が用意されています。 左側の目次は非表示にできます。 検索も使えます。 LaRec
ep.8 技術書典と Vivliostyle - 広がる CSS の活躍の場 | UIT INSIDE
花谷 (@potato4d) と緑豆はるさめ (@spring_raining) の二人で、技術書典、CSS 組版、Vivliostyle について話しました。 ゲスト紹介 spring_raining 2019/04 新卒 UIT 配属予定 Vivliostyle Organization core team https://techbookfest.org/ 4/14(日) に 6 回目が開催される技術同人誌即売会 毎回 1 サークルが数百冊〜数千冊を頒布するなど勢いが伸びている Web フロントエンド島は特に活気があり、目玉になっている Web 技術における執筆環境 執筆というと Word や TeX の印象があるが、今は Web 技術で可能 文書記述とレイアウト装飾は分け、 CSS で組版を行っていく Draft の CSS の機能を使うことによって、ページ単位にわけられた印刷用の
【Visual Studio Code】Markdown PDF のスタイル(CSS)を変える方法 - Nekonote
【Visual Studio Code】Markdown PDF のスタイル(CSS)を変える方法 ... のまえに、チョコさん。 パソコンの話はむつかしい ので、さきににゃんこ |ω･)و ̑̑༉ Visual Studio Code は、 Markdown を扱えます。 Markdown Markdown は 見た目キレイに変換できる テキスト形式のフォーマット です。 Markdown の詳細はこちらです。 ja.wikipedia.org Markdown は はてなブログ でも使えます。 以降では、 Markdown で書かれたファイル を、 Markdown とします。 Visual Studio Code には、たくさんの拡張機能があります。 拡張機能をインストールすることで、エディタの機能が増えます。 今回は Markdown を PDF にするので、 Markdown P
GitLab CI + docker-reviewを使って、Markdownをtextlintしてからpdf化するCI環境を作ってみた - メモ的な思考的な
最近、Markdownからpdfを作る機会がありました。 pdf化を都度行うのは手間だったため、何か良い方法がないかを探したところ、 Markdown > Re:VIEW > pdf という経路でpdfを作成できそうでした。 ただ、手動でpdfを生成するのが手間だったため、GitLab CIを使って、push後にMarkdownをtextlintしてからpdf化するCI環境を作ってみました。 目次 環境 GitLab CIの設定ファイル .gitlab-ci.yml の作成 ステージを定義 ジョブを定義 ジョブ「対象のMarkdownにtextlintを実行」の詳細を定義 ジョブ「Markdownをpdf化する」の詳細を定義 textlint向けの定義 prh.yml .textlintrc review-pdfmaker向けの設定 config.ymlの設定 pdf化するコンテンツの設定
ドキュメントサイトの管理にはNetlify＋静的サイトジェネレーターが便利 - Cybozu Inside Out | サイボウズエンジニアのブログ
こんにちは！開発部テクニカルコミュニケーショングループの仲田（@naoh_nak）です。 最近WeWorkみなとみらいに出没し始めました。おしゃれ過ぎて少し落ち着かないのですが、慣れたら自分もそちら側の人間だと思うようになるのかもしれません。 前回はヘルプサイトをマークダウンで制作する話をしました。そのサイトのホスティングにNetlifyを使うことでいい感じに制作プロセスを回せているので、今回はその話をします。 Netlifyもう使ってるよ！という方には今更の内容かもしれませんが、ブログなど小規模なサイトの運用に使っているケースが多いのではと思います（ネットにある情報を見る限り）。サイボウズのヘルプサイトは1万ページを超え、日英中3言語で運用しています。このような大規模なサイトでの運用例としての参考にもなれば嬉しいです。 Netlifyとは Netlifyって何？って方もいますよね。Net
プロダクトのヘルプサイトをマークダウンに移行した話 - Cybozu Inside Out | サイボウズエンジニアのブログ
こんにちは！開発部テクニカルコミュニケーショングループの仲田です。 皆さんマークダウン使ってますか？（唐突） 文書記法の一つで、プログラマーにとっては馴染みがあるものだと思います。サイボウズのプロダクト仕様書もマークダウンで書かれることが多くなっています。 ですが、公式ドキュメントを作る用途として採用される例はまだ少ないように思います。数ヶ月前になりますが、プロダクトのヘルプサイトをマークダウンに移行しましたので、今回はその話をします。 なぜ移行したのか マークダウンに移行した動機は、一言で言うとヘルプサイトの制作や更新を効率化するためです。 サイボウズでは、プロダクトのアジャイル開発化を進めています。アジャイル開発では、ウォーターフォール開発と比べてリリース間隔が短縮されます。パッケージ製品がメインだった頃には、リリースは年単位で、短くても数ヶ月ごとというスパンでした。ところが、クラウド
DocusaurusでPlantUMLを使う
DocusaurusでPlantUMLを使うSun, 24 Feb 2019 12:36:39 GMTサイト 静的サイトジェネレーター Docusaurus 会社でDocusaurusを提案したのですが「PlantUMLを使いたい」という意見がでました。PlantUMLは需要が高いのでおおかた標準もしくはプラグインがあるだろうと思って探したらありました。 remarkable-plantuml 環境はDocusaurus 1.7.2で試しました。DocusaurusはremarkableというMarkdownパーサーを使用しており、remarkableがプラグインによる拡張が可能なようです。前述のプラグインはそれを利用してDocusaurusにPlantUMLの描画機能を付与しているようです。 READMEに書いてあるとおり、yarnでインストールします。
Docusaurusを使ってみる試み
現在会社ではドキュメントをRedmineのWikiで管理しているのですが、個人的に静的サイトジェネレータの類でやりたいなぁ。と思ったのでDocusaurusというFacebook製のドキュメント生成ツールを試してみたメモ。 なんでDocusaurus 私はこのサイトでHexoを使っていて、ぶっちゃけHexoを使うのがスキルセット的に最もはやくできるのですが、いろんな公式サイトでドキュメント生成に使用されているとはいえ、Hexoはそもそもブログ特化というのとHexo以外のものも触っとくか。というので別の静的サイトジェネレータを試してみることにしました。 じゃあ、そうなったときにドキュメント特化の静的サイトジェネレータはなんやねん。という話でして、私が知っている限りでは下記の3つがあります。 GitBook Vuepress Docusaurus で、このうちまずGitBookですがGitHu
Markdownで執筆をした話 - すがブロ
Webアプリエンジニア養成読本 Advent Calendar 2014 - Qiita これの1日目です。 Webアプリエンジニア養成読本は みんなで「Webアプリエンジニア養成読本」を書きました！ - ゆーすけべー日記 でも書いてある通り、Github上のMarkdownを使って執筆しました。 ここでは、パーフェクトRuby / パーフェクトRuby on Railsを執筆する際はRe:VIEW*1を使っていた、という経験を踏まえた上での所感を書きます。 圧倒的メリット 閲覧がメチャクチャ楽という点に尽きます。とにかく、Github上で原稿を見るというのが非常に楽だし、マークアップも僕らの大好きなGithubフレーバーです。 ちょっとしたデメリット 致命的ではないけれど、以下の点はちょっと気をつける必要があります。 注釈やコードブロックなど、書籍用のマークアップはないので表現力に限界が
［特別記事］Vivliostyle.jsによるCSS書籍レイアウトをテストしてみました
［特別記事］Vivliostyle.jsによるCSS書籍レイアウトをテストしてみました HOME CSS組版 ［特別記事］Vivliostyle.jsによるCSS書籍レイアウトをテストしてみました Vivliostyle.jsは、株式会社Vivliostyleさんが開発しているCSS組版用のソフトウェアで、ChromeやFirefoxなどのWebブラウザだけで書籍の組版を実現します。具体的には、CSS Paged MediaやCSS Regions、EPUB Adaptive Layoutといった、ほとんどのブラウザに実装されていない組版用のCSS仕様をJavaScriptで実装しているとのことです（Web制作でポリフィルと呼ばれるものの一種かと思います）。 株式会社Vivliostyleさんのサイト 先日開発元のVivliostyleさんから使い方のヒントを教えていただいて大まかには理解
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
MkDocsによるドキュメント作成 - Qiita
Gatsby と Netlify で Jamstack 構成のブログサイトを作ろう
mdpreview/README.md at master · lwohtsu/mdpreview