Docsieで製品ドキュメントを公開する

Avatar of Author
Tal F.
on June 30, 2021 · · filed under Product Documentation AI Product Management Documentation Portals Technical Writing

</iframe

みなさん、こんにちは!

前回のビデオでは、製品ドキュメントの作成方法と製品ドキュメントの編集方法についてお話ししました。また、ビデオや写真、メディア、コードを埋め込んで、技術プラットフォームやソリューションについて顧客をさらに教育できるような製品ドキュメントを作成する方法を紹介しました。

今回は、Docsieの製品ドキュメントプラットフォームを深く掘り下げ、ソフトウェアドキュメントを簡単かつシンプルに作成する方法を紹介したいと思います。

ここでは、Docsieでパブリッシュする方法を説明するための簡単なチュートリアルを紹介します。

Docsieのナレッジポータルを使った出版は、いくつかの方法で行うことができます。このビデオでは、Docsieのナレッジポータル、ブック、シェルフ、アーティクルを1行の簡単なコードで公開する方法を説明します。

この例では、「Writing your first Django app, part 2」というこの特定の本を出版したいと思いました。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_vghRPvDGV9FcXW5sq/boo_IPAeUSAJvs2JsOCoT/8baf35b2-88ce-eb21-1eca-e13454c076beimage.png)

現在作成済みのソフトウェア・ドキュメントの中に、「Brand new portal that I am working on」というバージョンがあります。その近くにある「鉛筆」ツールをクリックすると、公開したポータルを「アクティブ」「プライマリ」にするか、これらの機能をオフにするかを選択できます。これは、あなたとあなたのチームがドキュメントを作成または更新しても、あなたのウェブサイトで製品ドキュメントとして公開する準備が整うまで顧客やクライアントに公開しないことができるということです:

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_Wpue5g2itHdkeHQWH/boo_IPAeUSAJvs2JsOCoT/e1957632-a49c-efea-8206-7ea31886a8dcimage.png)

これで公開の準備が整いましたので、ドキュメントを展開します! Docsieプラットフォームの右上にある3つの点をクリックし、自分のアカウントをクリックすると、簡単にできます:

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_Vyh10Vht9p5HgACri/boo_IPAeUSAJvs2JsOCoT/cc784b29-8edd-ade4-807c-cb6a30b61998image.png)

プロフィールと設定のページで、「デプロイメント」というタイトルのタブをクリックすると、デプロイメントページが表示され、ウェブサイトに配置されるエンベッダーコードの作成に役立ちます。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_FOdT3hJo8ygjq6lYH/boo_IPAeUSAJvs2JsOCoT/ed142930-2a7b-b56c-0ccf-3183c6191179image.png)

ここで、"新しい配置を構成する+"をクリックします。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_vbyck51UPHrWOVomu/boo_IPAeUSAJvs2JsOCoT/c3affc72-9cdd-b8ee-4c51-5798f54e5688image.png)

素晴らしい!ダッシュボードにアクセスできるようになったので、あとはカスタムドメインのデプロイを行うだけです。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_Xlx7uCVpKiy3TJbaI/boo_IPAeUSAJvs2JsOCoT/30f5281a-702a-9bd4-a926-9440f1aaef22image.png)

さて、次の2つのステップは簡単です:

1.最初のステップは、ドメインを入力することです(ドメイン名を書く前に、http:// または https:// を使用することを忘れないでください)。

  1. 第2のステップは、出版したいものを選ぶことです。あなたは、本や棚全体を出版する選択肢があります。この例では、「Writing your first Django app, part 2」という本を出版しています。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_Tac6kZ9pjFovGo8Ut/boo_IPAeUSAJvs2JsOCoT/2d5ad6d7-27fc-c487-f6bc-b97d7f1be44aimage.png)

素晴らしい!さて、コードを取得する前の最後のステップは、"+More Options "をクリックすることです。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_OrYP2ugvhlurWxfbJ/boo_IPAeUSAJvs2JsOCoT/390a98c1-f554-9ae3-7e09-8faed42d93a2image.png)

ナレッジポータルにスパイスを加え、ユーザーにとってより便利なものにするために、当社のさまざまなプラグイン、機能、その他のドキュメントオプションを使用できるようになりました。これらの機能、プラグイン、製品ドキュメントツールは非常に巧妙で、あなたのナレッジポータルをより強固なものにします。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_Wy76iK9zPT84NoPdu/boo_IPAeUSAJvs2JsOCoT/ed41417e-41dc-cffc-161a-4ffa182d3796image.png)

注:これらの追加機能およびプラグイン、その他の製品ドキュメントツールは、いつでも変更することができます。

完了したら、「Webポータルの作成」をクリックします。

ここで一番下までスクロールし、"+ デプロイメントスクリプトを入手する "をクリックします。

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_Lv7JtNkP26EPzxBTw/boo_IPAeUSAJvs2JsOCoT/6196219b-ddb3-55b8-d15f-3b08276ebbc2image.png)

そして、スクリプトをコピーして、HTMLに貼り付けてください:

![](https://cdn.docsie.io/workspace_WxPJSQ5gsES8Bzjxy/doc_ydgtE07E6Rp4AMmKv/file_C7q3zLB0gXrf4HObS/boo_IPAeUSAJvs2JsOCoT/550abafc-23f2-e1f3-138a-7435eca30e4fimage.png)

スクリプトにアクセスできるようになったので、CSSユーザーガイドを参考にして、あなたのブランドのルック&フィールに合ったスタイリッシュなDocsieナレッジポータルを作ってみてください。このリンクから、スタイリングのユーザーガイドをご覧ください: Docsieのスタイリングガイド

このチュートリアルを楽しんでいただけたら幸いです。今後もDocsieのチュートリアルにご期待ください!

Docsieがどのようにお役に立てるか、また、私たちのツールのデモをご覧になりたい方は、お気軽に ここをクリック して、私たちのデモをご予約ください。


Subscribe to the newsletter

Stay up to date with our latest news and products