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

マニュアルを書くのに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の方が速いかもね  

ImDiskの後継アプリのAIM toolkitを試してみた

ImDiskの開発辞めちゃったらしい というわけで、じゃあ後継ソフトはあるのかと思ったらあった 遅いと言われているけど・・・ とインストールしてみた ImDiskのこの間の結果はこちら 再びRAM DISK(ImDisk)   blog.mazepin-led.com    そして今回のAIM Toolkit なんか、無茶苦茶遅くなってるな 下手するとSSDの方が速いじゃん CPUの使用状態はこんな感じ PIO転送なところは変わって無さそう まあ、遅いからと言ってその速度が体感できるのかというと出来ないんだけどね と思ったところで、なんか設定変えてみたらどうなるのだろう Allocate Memory Dynamicallyというのは、メモリを必要に応じてってことだからと思って以前試したことがあったけど、なんかImDiskのときは不安定だったんだよな  AdvancedのとこにあるUse AWE Physical Memoryというのが良くわからないけど、チェックしてみたら速くなった おお、大分速くなった。なったけど・・・・なんで? これだとImDiskよりちょっと遅いくらいになるのか もしやQuickFormatととかでも変わるのか?と思ったけどそこまでやる気も無かったので放置。速くなるわけないよね。 後は圧縮とか、取り外しメディアとかだし。   最近の性能の良いSSDのおかげで RAM DISKというものの存在意義が薄れちゃったね まあそれでとにかく速度を稼ぎたいぜって人は SoftPerfect RamDiskでも使ってください 昔はPrimo Ramdisk使ってました。当時使ってたけどなかなか良かった。 当時SSD無茶苦茶高かったし。 今はほぼ無用になってしまったが・・・ 未だにスタンダード版は8GBまでなんだな キャッシュ領域にしたいなら大人しく余ってるSSDを使った方がいいんじゃ無いかって気がするけど  おしまい

再びRAM DISK(ImDisk)

PCに色々ゴミがたまってきたのでクリーンインストールし直した ・・ので、とりあえずある程度インストールが終わったので RAMディスクのベンチを取ってみた   RAM DISKを使ってみた(使ったのはImDisk)   blog.mazepin-led.com 前回はこんな感じでベンチ取ってたのよね 今回はこんな感じ 最初はなんか誤差のレベルだなーと思ってたけど、RND4KのWRITEが結構早くなってました CristalDiskMarkもImDiskも今日時点での最新版で試したので、まあ何か変わってるんだろう BIOSだってOSのバージョンだって変わってるしな システムディスクのSSDも変わってますがRAMやらCPUやらは当時のまま   一生懸命頑張っているCPUの様子がこれ。 基本、RAMディスクってPIO転送だからCPUのパワーをがっつり持って行ってしまう おしまい