スキップしてメイン コンテンツに移動

マニュアルを書くのにWriterSideを試してみた

えるいーだーのマニュアルについて

えるいーだーの新機能をリリースしました。

週末を使ってせめて新機能のマニュアルを作ろうとしたのですが、アプリを作るのと違って全く一筋縄でいかないうえに途中で投げ出したくなってしまった

WriterSide発見

何かいいツールねーかなーって探していたらWriterSideというドキュメント作成ツールを発見
つーてもβ版じゃねーか
とは言え、ツールがあるとは言えせこせこ自分でhtml,css書くよりはマシか?

使い方はこっちで解説してる

ちなみにダウンロードはこっち

JetBrainsのページが何故かカード作成ツールでリンク作成出来ないのでただのリンク


WriterSideでサンプル作成

お試しでテンプレートを使ってページ作成
htmlで出力される

そしてそのhtmlを書き換えて俺のページに統合(ッぽく)した

やだーなんかしれっとページの一部になってるわ~
よく見ると、著作権表示がトップあたりに移動したり・・・
中のスクリプトでなんか色々やってるっぽい

ちなみに出力されたhtmlはライトモードへも切り替えられるように最初から作られてる

WriteSide ライトモード

ライトモードにしてみた(右上のHelpInstanceの右端の半分色の変わった○をクリック)
・・・うーん、いらなくね? 

嬉しい誤算

嬉しい誤算だったのは、出来上がったページ全部に自分のページのテンプレートを作らないといけないかと思っていたらトップのページ(今回の場合だとdefault-topic.html)にテンプレートを組み込んだだけで他のページも全てテンプレートが適用されたこと。
読み込んだ最初のページの中に、他のページをロードしているみたい
この仕様は続けて欲しいなぁ。

WriteSideの将来

まあβ版ということは将来ガツガツ仕様が変わるとはおもうけど

  • 編集はmarkdownとxml
  • 現在は評価中ということで無料。まあ正式版になれば有料版があるけど無料版は残るみたい
  • 出力はhtml。それ以外はいらんでしょという態度w(まあpdfは対応するつもりはあるらしい)

使い始めたからつぶれないで欲しいなぁ・・・・
markdownとxmlって、俺は慣れてるけど個人開発者には結構ハードル高いかも
・・・むしろ中小企業で開発やってる人には辛いのか?

うちの会社なんかもmarkdownやめろって爺がいるし

途中まで作ってたページ

ちなみにさっきまでhtmlで作っていた
うん、こんな感じ
現実逃避のためにこのページを作ったわけじゃないよ。違うって

 

WriteSideじゃない

会社員がワンオペでボードのアプリ、スマホのアプリ、ドキュメントまで作るとこんなツールが無いと本当に辛い

えるいーだーのマニュアル頑張ります

素材

いくら便利ツールがあってもマニュアルの素材集めとかページの構成は自分で考えなきゃなら無いのよ

面倒くさいのよ~

 

おしまい


コメント

このブログの人気の投稿

RAM DISKを使ってみた(使ったのはImDisk)

GWだし、まあちょっとラムディスクを入れてみました うちのPCはWindows11 使ったのはImDiskというRAM Disk。 まあ、この辺のインストールとかはあちこちで解説してる人がいるので適当にぐぐってくださいな で、とりあえずベンチマーク なかなかいいスピードだ で、大抵の人はブラウザのキャッシュをRAMディスクにするといいよ・・・と言うけど そもそもメインドライブがNVMeのSSDを使っている状態で、体感速度なんか上がらない(使い終わったキャッシュを再起動したら綺麗さっぱり捨て去ってくれるという利点はある)  うちで一番効果があるのは Adobe Audition というアプリ これが結構高速化する(キャッシュをちゃんとRAMディスクにしたら・・・だけど) ハイレゾ音源だと、1時間の音源が何かする度に4GBのファイルを作られてしまう なので、RAM DISKにすると、結構編集時間を短縮できる Premiere Rushも出力先をRam Diskにしておいて終わったら、SSDにコピーすると言う事をやるとかなりスピードアップになる 実はうちのPCは普段は99%のパワーで動作していて、CPUのターボブーストが掛からないようになっている 大体3.6GHz当たりで安定してるのだけど、これを100%にするとターボブースト機能がONになって一部のコアが4.5とか4.8GHzまで上がる まあ、毎回電源オプションをいじる事になるのだけどさ・・・ そうしてベンチを取ると こんな感じ とは言え、ブーストしてるからと行ってRam Diskのスピードの差を体感する事はさすがに無理 ・・・と言うかフォトショでもRAM DISKにしてよかった・・・と言うほど変わらない SSDの性能が上がってきたしもし次にPCを買い換えたらRAM DISKよりSSDの方が速いかもね  

.NET MAUI BLE(Bluetooth Low Energy)も上手く行った

2023/10/11更新 ↓こちらの記事で更新しれました。 .NET MAUI PLUGIN BLEがWindows(10/11)に対応してた Windows対応 イヤッッホォォォオオォオウ Bluetooth LE plugin for Xamarin & MAUI がWindowsに対応してた~ nugetでver3.00をみんな早速ゲットだ。   ちなみにこちらはAndroid版のサンプルアプリ   GitHub...   [ブログカード風リンクタグ作成] ------------------------------------------------------------------------------ 昔、スマホとESP32の接続確認用に作ったプログラムをXamarinからMAUIに移植したら動いちゃった   まあ、ESP32からスマホへの一方通行なアプリなんだけど 面倒くさいので github に公開した 下手くそなコード書きやがってとか思われそう 「間違ってるぞこのやろう」というのを見つけたら教えてくれると嬉しいです 要素技術の調査はこれで完了かな

.NET MAUIでスプラッシュスクリーン Android12で地獄を見る

まずは起動するところから・・・・  スプラッシュスクリーンだぬ マイクロソフトのサイト 見てると簡単そう(実際簡単で細かい事を気にしなければsvgファイルを用意して1行だけ書き換えておしまい)   なんかプロジェクトファイルに自動で記述されるらしい よし、プロジェクト作った                     つーか、もうスプラッシュがあるんだけど・・・・ そして自作のsvgファイル くうっ・・・デザインセンスない・・・・   それはともかく、このSVGファイルを Resources\Images にドラッグ&ドラッグ プロジェクトを右クリックして「プロジェクトファイルの編集」 して、編集できるようになったプロジェクトファイルを 自分のプロジェクトファイルに書き換える <MauiSplashScreen Include="Resources\Splash\splash.svg" Color="#512BD4" BaseSize="168,168" /> ↓ <MauiSplashScreen Include="Resources\Splash\ splashtestmaui .svg" Color="#512BD4" BaseSize="168,168" />   とりあえずAndroidで実行 お、おう・・・・ まあ最初はこんなもんよね 最初に紹介したマイクロソフトのサイトでもBaseSizeを書き換えてくださいって言ってるし 言われたとおりに <MauiSplashScreen Include="Resources\Splash\splashtestmaui.svg" Color="#512BD4" BaseSize=" 320,600 " /> 書き換えてみると いい感じじゃーん じゃあアンドロイドのバージョン毎に試してみよう   Android 7 Android 11 Android 12 Android 13 ...