Store documentation in one or more repositories No matter how many git repositories you use, Antora can retrieve and aggregate all the content from them to assemble a documentation site. Workspaces that fit team and content requirements Since documentation files can be stored in separate repositories, the teams that maintain them can use the administration policies, version schema, and release sch

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

ご存じの通りこのブログは私の大好きなWordPressを使っていますが今回はちょっと変わり種の紹介。 このエントリで扱っている内容はかなり古くなっています。日本語READMEもふるくなっているため英語版のReadmeなどを参考に。といってもあまりメンテされていないようですが……(あとこの記事内の画像は複数欠落しています) HubPress、しってますか？ HubPressはちょっと特殊なブログアプリです。ちなみにGithubページを利用したブログを構築できる・「HubPress.io」 – かちびと.netで存在を知りました。一ヶ月半ぐらい前ですね。 takkyuuplayer氏によるREADME-jaがあったのでそれの追加修正をさっせてもらってます。(何度もPRやissueを送ってたらコラボレーターになりました。write権限は無いけど。)(もちろんPR大歓迎なんだからねっ！) 何が特殊

Help us understand the problem. What are the problem?

asciidocとは asciidocはMarkdownなどのような軽量マークアップ言語の一つで、Webページなどをプレーンテキストで記述することができる(拡張子は.adoc) asciidocを使うようになった経緯 これまではWordで機能仕様書とか書いていたが、Wordは重い、変更場所が分からない、複数人同時に修正とか面倒で、いい加減Wordを使うのは止めたくなった なので軽量マークアップ言語にしよう、一番メジャー？なMarkdownにしたら、以下の制約とかでいくらなんでもイマイチ。。 表でセルの結合ができない 表のセル内で箇条書きができない 目次が作れない 文字に色がつけられない 上記に対応しようとすると、プラグインやらMarkdown亜種がいろいろ。。 そこで、Markdownより表現方法が豊富なasciidocを使用し、実際に使って、特徴・課題を挙げてみた。 asciidocto

Pro Git第2版の驚くべき冒険と最終的なツールチェーン ほぼ6年前、私はApressから執筆が予定より遅れていたPro Gitと呼ばれる本の手伝いの誘いを受けました。結局原著者が書き続けないことを決めて、私が最初から書き直して2009年8月頃に最終的に出版されました。最初の3章あたりは、私はWordで本を書きました。そして編集者に文書を送って、しばらくして最終的な版を手にしました。 この3章のあとで、私たちが執筆と技術的な編集段階のためにMarkdownに切り替えて、同意された編集のためにだけWordへ戻るように提案したとき、私はやめようとしていました。一旦本が完成したら、私はすべての内容をMarkdownへ再び戻したので、それを私が作成したWebサイトにおいてオンラインで発表できました。幸運にも、原著者は著作をクリエイティブ・コモンズ・ライセンスとすることでApressと同意しました

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

この3つの原則は書籍の構成にも現れています。 第一部の基本文法で「書き方」を学び、第二部のユースケースで「作り方」を学べるようになっています。 「学び方」は、章としてではなく全体的な流れとして取り入れることにしました。 なぜなら、「学び方」自体は学びたいことによっても異なる方法を取る場合があります。 そのため、「学び方」で個別の章とするよりは、他の章で「書き方」や「作り方」と一緒に見たほうがよいと考えたためです。 たとえば、基本文法などの学び方にはMDNのようなリファレンスサイトを見たほうがいいし、 アプリケーションの作り方は実際のサイトなどを参考にしたほうがよいためです。 第一部と第二部がどのように書かれたのかをざっくりと振りかえってみます。 第一部: 基本文法 第一部: 基本文法はJavaScriptの基本的な文法について扱っています。 プログラミングの入門書で文法については避けること

Forget building your own custom docs platform. With GitBook you get beautiful documentation for your users, and a branch-based Git workflow for your team.

はじめに 皆さんはエクセル方眼紙が好きですか？ エクセル方眼紙で設計書や手順書を作っている現場は未だに多いですよね。 私は好きではありません。正直つらいです…。やめたいです…。 なにがつらいのか 目次を自動生成できない 項番を振り直せない 相互参照機能がない 条件付き書式や名前定義がすぐに壊れる1 Gitホスティングサービスでプレビューできない Git上で差分が見れない 好きなツールでgrepできない 本来の表計算ソフトとしての使い方をした上で補足文章を記載する程度に留めたり、 作りっぱなしでメンテしなくていいような場合はエクセル方眼紙でも別段かまわないのですが、 メンテを考えると上記のような問題点が浮き彫りになります。 大規模システムのテーブル構造に変更があったときの影響範囲調査のために エクセルファイルを一つ一つ開いて確認したことがありましたが、あれは中々に地獄でした…。 代替案を考え

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?

Jekyll とか Hugo とかで AsciiDoc や Markdown を書くとき，ファイルの先頭に YAML (たまに TOML) を入れることがあります． フロントマター (front matter) と呼ばれるやつです． このフロントマターが入った AsciiDoc を VS Code で扱うのにいろいろ設定をしたので，ここにメモしておきます． ちなみに，設定がうまくいったときのスクリーンショットはこんな感じです． AsciiDoc プラグインのインストール まずは AsciiDoc 用のプラグインをインストールします． AsciiDoc - João Pinto https://marketplace.visualstudio.com/items?itemName=joaompinto.asciidoctor-vscode Ctrl+P を押して次のコマンドを叩けば，インスト

はじめに 流用性・検索性が高いドキュメントの作成は今後のエンジニアに求められるスキルの一つです。 一方で社内ではPowerPointやWordによるドキュメント作成が頻繁に行われる事が多いのではないでしょうか？PowerPointやWordは即時性が高いフォーマットですが、流用性・検索性を確保し続ける事が困難です。 エンジニアが気軽に出版レベルのドキュメントを作成したり、Wikiより管理の容易なナレッジを作成するのに役立つAsciiDocをご紹介するとともに、より柔軟な運用について提案したいと思います。 AsciiDocとは AsciiDocは軽量マークアップ言語の一つで可読文書記述形式です。 出力もHTML, PDF, ePubなどが行えるため個人での出版活動から開発環境でのナレッジの共有まで様々な用途で利用する事が可能です。 AsciiDocの記述方法 軽量マークアップ言語でメジャーな

Markdown記法のチートシートです。 記法はGitHub Flavored Markdownに準拠し、一部拡張しています。 Qiitaでシンタックスハイライト可能な言語一覧については、 シンタックスハイライト可能な言語 をご覧下さい。 Code - コードの挿入 Code blocks - コードブロック たとえば、「Ruby」で記述したコードをファイル名「qiita.rb」として投稿したいときは、 バッククオート（`） か チルダ（~） を使用して以下のように投稿するとシンタックスハイライトが適用されます。 コードブロック内でコードブロックを書きたい場合は異なる記号を使うことで書けます。

Gollumとは gollumとはgitで作られたwikiエンジンです。個人の環境に無料で立てられるwikiサーバーとしては、簡単に立てられ、またデザインや操作方法も非常にシンプルなので手軽に始められるのが特徴だと思います。 gitで動くので、gollumのインストール以外にDBなどの他のミドルウェアは必要ありません。gollumには認証機能がありませんが、--configオプションでBasic認証やOmniAuthを実装したrbファイルを指定できるので、簡易的な認証機能としては十分です。 以下のような人に向いているwikiエンジンだと思います。 - 手軽に個人環境にwikiサーバーを立ち上げたい - 使い方はシンプルな方が良い - 日本語の全文検索をしたい - グループで使用できて、作成・編集にだけ認証をつければ良い　→　URLさえ知ってれば誰でも見せたい - ある程度デザインは拡張でき

わかること。 Gollumのインストール・起動方法 GollumとGuardの連携 Gollumの日本語ファイル対応(やっつけ) 概要 GollumはGitをバッグエンドにruby + sinatraで構築されたシンプルなマークダウン Wikiです。 シンプルといっても[[_TOC_]]という書き方で目次を生成してくれるなど、欲しいなと思った機能はギリギリ備えている印象です。 しかし、日本語のファイル名を扱うことができないなど、実用途にはいささか不足な部分も存在します。 そこで、以下のような工夫を行います。 Guardを使用してリポジトリにファイルが追加されたら自動でGollumに反映されるようにする 日本語ファイル名を扱えるようにする ホスト環境は以下。 4.4.0-104-generic #127-Ubuntu SMP Gollumのバージョンは4.1.2。 rubyのバージョンはru

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

https://github.com/gollum/gollum 研究室内の連絡・情報共有は、フロー型の情報ならSlackで、ストック型の情報ならWikiで。 という方針になったので、学内ネットワークで閲覧編集可能な自前Wikiサーバーを立てる。 開発環境は macOS, 本番環境は Ubuntu 18.04 → 20.04 → 22.04 LTS. ソフトウェア選定 pukiwiki 学生のときの研究室で使ってたので馴染み深い。 でも独自記法だしphpとか文字コードとか考えたくないので却下。 crowi Node.js + MongoDB で動くモダンな Markdown wiki。 生のファイルが見えないデータベースっぽいので管理が難しそう。 growi はこれをフォークしたもので、 機能もドキュメントも強化されてるし、 docker-compose とかですぐ使えるのも楽ちん。 日本

AsciiDocとは AsciiDocはMarkdownなどのような軽量マークアップ言語の一つです。 利用例 Pro Git book - Github オライリーの書籍 Clojure Cookbook - Github Programming Scala Mastering Bitcoin - Github Open Government - Github O’Reilly Atlas Neo4j documentation - Github Git User's Manual なぜAsciiDocを使うのか 表現力と可読性 技術文書を書く場合HTMLは汎用性が高いが可読性が低い、一方Markdownは可読性が高いがテーブル記法がないなど表現力が乏しい。 AsciiDocは可読性が高く表現力もある程度高いので、技術文書等を書くには最適である。 表現力：HTML > AsciiDoc >

引退した盲導犬は老犬ホームか老犬ボランティアヘ行って余生を過ごすそうです。オリバーは幼いころを共に過ごしたパピーウォーカーに引き取られました。オリバーは家族のことを覚えているのでしょうか・・・こちらもご覧ください。 http://www.youtube.com/watch?v=GLphODar-Sw

アンリアルエンジン5には、これまでにないリアルタイムコンピュータグラフィックスの技術が含まれています。 仮想化マイクロポリゴンジオメトリの Naniteにより、アーティストはポリカウントを気にすることなくビジュアルを作成できます。 そして、Lumen を使用すると、完全に動的なグローバルイルミネーションで比類のないリアリズムを実現できます。 この簡単な概要では、これらの機能などについて詳しく説明します。 詳細は https://www.unrealengine.com/ja/blog/a-first-look-at-unreal-engine-5 をご覧ください

Unreal Engineフォトリアルなビジュアルと没入的体験を作り出す世界で最も高度なリアルタイム 3D 制作ツールです。 Unreal Engine 5機能紹介最新機能ライセンス オプションUnreal Editor for Fortniteその他の製品MetaHuman高忠実度のデジタルヒューマンを短時間で作成できるフレームワークです。 Twinmotionリアルタイム没入 3D ビジュアライゼーションを高速に、簡単に制作します。 Bridge by QuixelMegascans と 3D コンテンツ世界へのゲートウェイです。 RealityScan写真を高精細な3Dモデルに変換する3Dスキャンアプリです。

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

雑記ブログ：技術選定2「スレッド形式にしたい」Closedfirst published: 2018/12/13last updated: 2019/01/15 雑記ブログを2週間書き続けて、割とちゃんとしたブログに向かっているけど...。ブログ書きたいってよりは「GitHub Issues的なものが書きたかったので、理想と少し違う。 GitHub Issuesは1つの投稿の中にコメント（自分の場合は思いつきの独り言や試行錯誤）を積み重ねていく感じ。ブログだと全体編集・追記を個別に書くことになる。 独り言らしさを出すにはどうすればいいだろう。他の例だとToggeterとかTwistとか。要は、独りで発言を積み重ねられるスレッド形式で作れればいいんじゃないか？ GitHub Issuesブログ ぱっと思いついたのは、miyaokaさんが作っていたGitHub Issuesブログ。あれはNux

雑記ブログ：技術選定4「WPcomの活用」Closedfirst published: 2019/01/02last updated: 2019/01/15 技術選定3の続き。うーん、高機能なheadlessCMSほど依存性が高い...。 生存競争の激しいheadlessCMS同士のインポート・エクスポート問題はそう簡単に解決しないだろうし、仮にJSONで吐き出せても上手く変換して移行先に移せる自信はないよ。 そういえば、prismicのSlice機能を使っててWordPressのGutenbergを思い出した。あれって、Gatsbyに引っ張ったらどうなるんだ？さすがにメジャーリリースされた機能を無視してはいないだろう。 サーバーレスにしたいので、WPcom（Free Plan）でテスト。 プラグインの追加はビジネスプラン以降だけど、Jetpack（基本機能）はプリインストールされているの

雑記ブログ：技術選定3「パフォーマンスと生存率」Closedfirst published: 2019/01/02last updated: 2019/01/15 実験してきたJAMstackな技術をそろそろ他の制作物に転用していきたい。フロントは静的サイトならGatsby、Webアプリ系ならNuxt、ビルドとホスティングはNetlifyが安定しているけど、バックエンドが未確定。 DatoCMS（headlessCMS）はダッシュボードの処理速度が若干鈍く、気になり出していた。少しバグもあるし。引越しが大掛かりになる前に他のCMSも検証し、今後メインで使うものを決めよう。 ダッシュボードのパフォーマンス メディア管理のしやすさ リミットと料金形態 DBの永続性・汎用性 APIの使い方はほとんど同じなので、上記4点が検討材料になる。 画像倉庫として有料のGyazoを使うのはいいんだけど、管理

50+ Features From localization to custom validation, explore everything you can do with Directus.

売れるネットショップ研究所 橋本技研の技術系備忘録ブログ。 ショッピングカートシステムの制作などが得意です。 昨日のNuxt.JS + SSR 爆速化の記事に引き続き、珍しくブログを連投しています。 最近はheadlessCMSにReactやVueといったフロントエンドを組み合わせてウェブサイトを作ることが流行っていますよね。 Contentfulとか、最近では国産のMicroCMSなんかも熱いみたいですしね。 headlessCMSについてググると、ContentfulとかStrapiに関する記事はたくさん出てくるのですが、DirectusとかCockpitに関してはあまり出てこないので、ちょっと書いてみたいと思います。 昨年からいくつかのheadlessCMSを試していたのですが、最初に試したのがStrapiでした。ふむふむ、これは面白いぞ！デザインも素敵！と思ったのですが、繰り返しフ

はじめまして！ジェネロテクノロジーの東 百合（あずま ゆり）と申します。 ジェネロでは、当社イメージキャラクター兼Drupalに関わるマーケティングのお仕事をしています。 現在はマーケティングを担当していますが、学生時代は、自宅にサーバーを立てたり、先生に内緒で研究室にWLANを設置したりとITインフラにどっぷり浸かっていた理系女子です！ どうぞよろしくお願いいたしいます！ さて、ときどき大きな本屋さんに行ってコンピュータ関連書籍のコーナーでCMS（コンテンツ管理システム）の本を探すと、WordPressの本をたくさん見かけると思います。 でも、残念なことにDrupalを紹介した本はほとんどありません・・・ ネットにもDrupal関連の日本語情報はまだまだとても少ない状態です。 世界のCMS市場では、Drupalが大きく注目されているのに、日本での知名度が今ひとつなのは、Drupalの日本

昨日、Facebook製のReact用ステート管理ライブラリRecoilが発表されました。Facebook製といってもReact公式のステート管理ライブラリとかそういう位置付けではないようですが、それでも大きな注目を集めているのは間違いありません。 そこで、筆者がRecoilに対して思ったことや、筆者の視点から見たRecoilの特徴を記事にまとめました。 なお、この記事の執筆時点では副作用の扱いなどの点はいまいち情報が揃っていません。この記事では速報性を重視し、コアのステート管理部分に絞って考えています。また、まだexperimentalなライブラリなので、今後この記事の内容からRecoilのAPIが変化したとしても悪しからずご了承ください。 この記事を書くときに筆者が色々試していたCodeSandboxはこちらです。 https://codesandbox.io/s/recoil-san

NTTデータ先端技術株式会社は、基幹業務情報の設計、統合、運用および最新技術上構築された通信システムプラットフォームを通じて、貴社のビジネスに価値を提供する専門的な企業です。

今回のテーマはHeadless CMSです。Drupalの生みの親で、世界的なDrupal関連企業、AcquiaのCo-FounderでもあるDries Buytaert氏のブログを紹介します。 Drupal is API-first, not API-only 開発者の多くが、Headless CMS（ヘッドレスCMS）として知られるcontent-as-a-serviceソリューションを選ぶようになってきています。Headless CMSは、余計なものを省いた編集用インターフェースと、あらゆるアプリケーションが利用するためのコンテンツAPIを提供するストレージとなります。 Headless CMSはいくつかの共通する特徴があります。エンドユーザー側のフロントエンドがないこと、表示したりレイアウトするための編集画面がほとんどない、もしくは全くないため、フロントエンド開発者にとっては、どう

ちょっといつもと毛色の違う記事書きますね。 Twitterアカウントの乗っ取りは昔から問題にはなっているのですが、いまいち纏まった対策法が書いているところが少ないなーと思っていました。最近になってまた…

Contentfulを使ってみたくなったので、印象に残った邦画を書き残すブログを作りました。ブログを作って満足してしまったので、記事の中身は（仮）です。Contentfulの考え方に馴染むのに少し時間がかかったので、そこのところの整理がメインの記事です。 ヘッドレスCMSというもの CMSというと、WordPressとMovable Typeぐらいしか知らなかったのですが、最近ヘッドレスCMSという言葉を耳にするようになりました。ヘッドレスCMSは、WordPressのようにテンプレートを表示する部分を持たず、APIでデータを提供することに特化している点が特徴です。 ヘッドレスCMSの選択肢は、こちらのサイトにたくさんありましたが、そのなかで、ContentfulというCMSのサービスが気になったので、Nuxt.jsと組み合わせて簡素なブログを作りました。 headlessCMS | A

Strapi is the leading open-source headless CMS. It’s 100% Javascript, fully customizable, support TypeScript and developer-first. It saves API development time through a beautiful admin panel anyone can use.

7年間使ってきたWordPressを捨ててContentful+Gatsby+Netlifyにしたら爆速になったし経緯とか教訓とか語るWordPressReactNetlifygatsbycontentful こんにちは、古都ことと言います。普段はブログやらなんやらをやっているのですが、今回ブログのお引っ越しをしたのでその経緯などについてお話ししたいと思います。 先にまとめ ブログをVPSとWordPressで7年間運営してきた 速度面やメンテナンス面でそろそろガタがきていた Contentful+Gastby+Netlifyの構成に移行した Lighthouseで高スコア叩き出せた 技術選択って難しいね 運営しているブログ Subterranean Flower Blogというブログをやってます。 主にフロントエンド周りのことを取り扱っており、たまにマリオ64の記事や、転職の記事などでも