ITエンジニア/デザイナ向けにオープンソースを毎日紹介

ドキュメントの記事一覧

プレミアムユーザー限定記事

MOONGIFTプレミアムは、月額500円の有料サービスです。詳細はこちらから

もっと見る

None

  • Premium_s 2016/05/13

読みやすい開発者向けドキュメントとは?

仕様書、ヘルプファイル、Webサービスの開発者向けガイドなど開発者向けにドキュメントを書くことがよくあります。せっかく書いたドキュメントが全く読まれていなかったり、逆に人が書いた文章がとても読みづらく感じることはないでしょうか。そこで今回は開発者ドキュメントにフォーカスして読みやすくする方法を紹介します。## 文体を統...

List

  • Premium_s 2014/04/18

業務で使えるオープンソース(109)「ドキュメント管理」

今回のテーマはドキュメント管理です。殆どの企業ではWindowsのファイル共有を使ってオフィス内でファイルを管理していると思いますが、それでは物足りなくなったり、ファイルをコピーして使い回したりした結果、どれが最新か分からなくなって運用が煩雑化します。それを助けてくれるのがドキュメント管理です。得手不得手はありますが、...

List

  • Premium_s 2014/02/07

業務で使えるオープンソース(98)「Web APIドキュメント」

今回のテーマはWeb APIドキュメントです。Web APIの現状と、その公開による影響、ドキュメントに求められる要件などをまとめました。以下はプレミアムのみです。

None

  • 2014/01/30

aegifが考える企業でOSSを開発するメリット、デメリット!

aegifはエンタープライズ向けオープンソース・ソフトウェアを用いたコンサルティング、導入サポートを行っています。例えばLiferay(エンタープライズ向けポータル)やAlfrescoを得意としており、さらに最近では自社でCmisSync、NemakiWareといったECM製品を開発しています。※ aegif社はLif...

None

  • Premium_s 2013/10/22

記事の書き方をこっそり変えてみたとその効果

今回は先日よりトライしているMOONGIFTでの記事の書き方を変えてみた内容を紹介します。また、それによる効果についても紹介します。ソーシャルで拡散できる記事を書く際などの参考にしてください。

List

  • Premium_s 2013/05/07

業務で使えるオープンソース(75)「開発用ドキュメント」

今回のテーマは開発用ドキュメントです。ドキュメントというと、後で役に立たない、工数ばかりかかる、メンテナンスが大変というイメージがありますが、それでも必要なものは必要です。そこでより開発チームに適したドキュメントを作成するテクニック、ソフトウェアを紹介します。

23354?type=list&url=http%3a%2f%2fwww.moongift.jp%2fwp-content%2fuploads%2f2010%2f11%2fscreen-shot-173

  • 2010/11/10

様々なフォーマットに対応したドキュメントビューワー「docnext」

docnextはiOS/PC/Android(予定)に対応したドキュメントビューワー。MOONGIFTはこう見るScribdやSlideshareに代表されるオンラインのドキュメント共有サービスが一時期もてはやされたが、今では少し鎮静気味になっている。ドキュメントのオンライン化は、電子書籍や電子教科書等の分野でも活用が...

List

  • 2010/03/30

ブラウザベースのドキュメントビューワー「FlexPaper」

FlexPaperはFlex/Flash製のオープンソース・ソフトウェア。筆者は昔、Memotuneというサービスを行っていた。ScribdやSlideShareに代表されるドキュメント共有サービスだ。肝になるのはPDFやWordなどのオフィスドキュメントをFlashに変換し、それを閲覧する部分になる。Flashに変換...

List

  • 2009/09/29

CSSで自動生成ドキュメント「CSS Doc」

CSS DocはRuby製のオープンソース・ソフトウェア。プログラミングソースを複数人で参照するときや、ライブラリを開発した際に必要なのがドキュメントだ。最近では各言語向けに○○Docと呼ばれるものが普及している。これにより関数やメソッドの前に特定のシンボルを付けつつ説明を書くだけで後々コマンド一つでソースドキュメント...

List

  • 2009/08/09

ePubフォーマットにも対応した電子書籍エディタ「Sigil」

先日アメリカの投資会社VCCが発表した今後5年間で伸びると思われる分野の一つに「電子書籍」が挙げられている(参照)。確かにAmazonのKindleやiPhone/Androidといったスマートフォンによって電子書籍の市場は成長しているようだ。そんな電子書籍のフォーマットとして採用されているのがePubフォーマットだ。...

List

  • 2009/08/03

PHP製のナレッジマネジメントシステム「68KB」

企業におけるナレッジマネジメントはとても難しい。少人数であれば暗黙知も良いだろうが、人数が増えれば徐々に知識のずれが生じてくる。それを補うにはアナログツール、メール、井戸端会議、Webベースのシステムなど様々に存在する。説明書きにツールチップが表示される 最終的には人と人の付き合いになるだろうが、それでも知識の定着を促...

List

  • 2009/06/24

リアルさを追求した、Flash製のドキュメントビューワー「MegaZine 3」

最近はAmazon KindleやiPhoneなどの盛り上がりもあって、電子書籍ビューワーに注目が集まっている。読みやすさもさることながら、あの書籍のページをめくる感覚や、紙のすれる音がないとどうも…という人も多いかも知れない。クリックしてページをめくるドキュメントビューワー そのような方にお勧めできるドキュメントビュ...

List

  • 2009/05/22

便利!MS OfficeとGoogleドキュメントをコラボレートする「OffiSync」

最近、対外的に文書をやり取りする際にGoogleドキュメントを利用することが多くなっている。とは言え、常にオンラインで書くことはなくテキストエディタで書いて、文章を貼付けて画像を埋め込んで仕上げる…といった手間をかけている。MS OfficeにGoogleドキュメント連携機能を追加する 恐らくGoogleドキュメントで...

List

  • 2009/05/04

プログラマだけじゃない。ライターな方にも便利なバージョン管理の使い方「Flashbake」

元々バージョン管理システムはプログラマが利用していたシステムだ。だが、その便利さゆえにシステム開発会社などではデザイナの方も利用している。さらにそれが広まると全社的に使われることもある。ライターの方に便利なバージョン管理の使い方 バージョン管理を使えば、間違っても戻ることができるので思い切った作業も行えるようになる。そ...

List

  • 2009/05/03

Googleドキュメントでも集中して物書きに勤しむ「WriteRoom for Google Docs」

背景や余計な機能を一切見せず、物書きだけに集中できるソフトウェアがWriteRoomだ。当サイトでも類似のソフトウェアを幾つも紹介してきた(Dark Room:Windows、PyRoom:Linux、Writespace:MS Word、TextRoom:Windows/Linux、JDarkRoom:Java)。こ...

List

  • 2009/04/15

長文を分割&横スクロールで見やすくする「bookreader.js」

Webの発達で日本語であっても横に読まれることが当たり前になりつつある。コンピュータ上では縦に際限なく伸びていくので、縦書きは読みづらいのだろう。だが横向きに書かれていても長文であると見がたくなるのは変わらない。長文をブラウザ上で読むならこれ 特に小説やコラムなど長文を載せているサイトの場合はそうだ。コンピュータは元々...

List

  • 2009/04/14

PHP+MySQLのシンプルなドキュメント管理「Maris SimpleDocu」

開発者向けのドキュメントは必要な情報が載っていればインタフェースはシンプルでも良い。もし社内でドキュメントを共有しようと思ったら、まずは簡単に書けるものを選ぶ必要がある。Wikiを使うのも手だが、記法を覚えるのが面倒という人もいるだろう。インデックス。ドキュメントをツリー表示する そこでもっと簡単に使えるドキュメント管...

List

  • 2008/11/30

Markdown記法をJavaScriptで「Showdown」

個人的には一番好きな記法であるMarkdown。Wikiも良いのだが、エンジンによって記法のばらつきがあるのが問題だ。その点、記法だけを考えればMarkdownは統一されているので、シェアさえ広がれば皆使えるようになる。Markdown記法のリアルタイムプレビュー だが書くときはテキストエリアで、実際のレンダリング結果...

List

  • 2008/11/07

目指せ小説家!「StorYBook」

インターネット上で小説を公開している人は数多い。アニメや漫画を題材にした二次創作ものまで含めると相当数の作品が存在しているだろう。趣味の人が多いだろうが、中にはプロを目指している人もいるかも知れない。小説専用のソフトウェアだ 最近では携帯小説なども流行っているので、本格的なプロットをして書き上げれば一躍小説家としてデビ...

List

  • 2008/10/19

テキストから各種ドキュメントへ変換する「txt2tags」

開発用のドキュメントと、提出用のドキュメントと二つ書かなければならないことがある。どちらも似たような内容だが体裁が異なる。だがそのためにコストをかけるというのは非効率的だ。テスト文書 この手のソフトウェアは数多く存在するが、開発ドキュメントの管理にWikiエンジン(DokuWikiなど)を使っているなら、これの利用はあ...