の呟きは 53
https://go.dev/blog/godoc
古いなあ・・・godocは2つある・・・
https://pkg.go.dev/golang.org/x/tools@v0.1.7/cmd/godoc
https://pkg.go.dev/golang.org/x/tools@v0.1.7/godocうーん
godocもgo docも僕が期待している動作ではない・・・解決策ェ・・・
スタックオーバーフロー眺めた感じ
godocのローカルサーバー回してwget/curlなりのコマンドで保存か
ページごと生成をリダイレクトで保存か
godoc -url /pkg/github.com/neetsdkasu/fizzbuzz/ > fizzbuzz.html
ひどしこのページ保存、ライセンス問題がありそうだから、プライベート利用以外では厳しいのでは・・・
pkg.go.devというサイトの特権みたいな感じ・・?
皆が自由勝手に配布するのも
まぁ大変な部分はあるが
どうなんだ・・・?
CC BY 3.0は大丈夫っぽい・・・?
- (UPD ) #
そもそも下部の
Terms of Service | Privacy Policy
あたりが邪魔だから
やはりそのままコピー利用は厳しいのでは・・・?
shower time
- (UPD ) #
売りにいく第1弾を揃えた
第1弾は15タイトルで合計18冊くらい?
運がよくて180円・・・
まぁおそらく50円にもならなそう(omitted)
(omitted)
(omitted)
95円で売れた・・・
1冊ネットオフよりは安かったが
トータルではネットオフで売るよりかは値が付いた感じはするが
おそらく、ネットオフだとダンボールやら送料やらで1冊あたりが安くなってしまうのかもしれない・・・
次売る4タイトル合計19冊を決めた・・・
現状、20冊弱しか運べておらず
1000冊近くあることを考えると、全部売却に50日かかる・・・
それも外出可能な日のうち、ブックオフへチャリで行ける天気のときのみ・・・それが合計50日必要、という・・・予定ではバッグが1つ増える予定だが、
そのバッグがあればもう20冊は運べるはず・・・
容量的には30冊いける可能性もあるが
重すぎるだろJK
なんか、よつばとの2,4,6巻が行方不明・・・
アクセスしやすい場所には保管してなかったっぽい・・・
場所を特定できず
(omitted)
- (UPD ) #
なのはA'sやStrikerSのコミックや
吼えろペンとか逆境ナインとか
ブララグの人のSHOOK UP!ってコミックや・・・
たぶんまだある・・・ナポリタンがあった・・・
何故TS物を・・・?
fsdocsダメだわ・・・
$ fsdocs build
cracking projects...
skipping project 'Mt19937ar.fsproj' because an error occurred while cracking i
t: System.Exception: project 'C:\fs\mt19937ar_fs\Mt199
37ar\Mt19937ar.fsproj' not restored
at Microsoft.FSharp.Core.PrintfModule.PrintFormatToStringThenFail@1433.Invoke
(String message) in D:\workspace\_work\1\s\src\fsharp\FSharp.Core\printf.fs:line
1433
at FSharp.Formatting.CommandTool.Crack.crackProjectFile[a](a slnDir, FSharpLi
st`1 extraMsbuildProperties, String file) in /home/runner/work/FSharp.Formatting
/FSharp.Formatting/src/FSharp.Formatting.CommandTool/ProjectCracker.fs:line 236
at FSharp.Formatting.CommandTool.Crack.projectInfos@319.Invoke(String p) in /
home/runner/work/FSharp.Formatting/FSharp.Formatting/src/FSharp.Formatting.Comma
ndTool/ProjectCracker.fs:line 321
Warning: While cracking project files, no project files succeeded.
please set '<FsDocsLicenseLink>' in 'Directory.Build.props'
please set '<FsDocsReleaseNotesLink>' in 'Directory.Build.props'D:\workspace\~って何やねんな・・・
- (UPD ) #
今度は成功した・・・?
$ fsdocs build
cracking projects...
Inputs for API Docs:
C:\fs\mt19937ar_fs\Mt19937ar\bin\Debug\net5.0\Mt19
937ar.dll
Substitutions/parameters:
root --> /Mt19937ar/
fsdocs-authors --> Leonardone @ NEETSDKASU
fsdocs-collection-name --> Mt19937ar
fsdocs-collection-name-link --> /Mt19937ar/
fsdocs-logo-src --> /Mt19937ar/img/logo.png
fsdocs-navbar-position --> fixed-left
fsdocs-theme --> default
fsdocs-logo-link --> /Mt19937ar/
fsdocs-license-link -->
..成功してませんでした・・・
Error :
System.IO.FileNotFoundException: Associated XML file 'C:fs\mt19937ar_fs\Mt19937ar\bin\Debug\net5.0\Mt19937ar.xml' was not found.
at <StartupCode$FSharp-Formatting-ApiDocs>.$GenerateModel.assemblies@2180-1.I
nvoke(Tuple`2 tupledArg) in /home/runner/work/FSharp.Formatting/FSharp.Formattin
g/src/FSharp.Formatting.ApiDocs/GenerateModel.fs:line 2223
at Microsoft.FSharp.Primitives.Basics.List.choose[T,TResult](FSharpFunc`2 f,
FSharpList`1 xs) in D:\workspace\_work\1\s\src\fsharp\FSharp.Core\local.fs:line
189
at FSharp.Formatting.ApiDocs.ApiDocModel.Generate(FSharpList`1 projects, Stri- (UPD ) #
失敗した原因
fsprojファイルのあるディレクトリでfsdocs buildしてなかった
失敗した原因
docsディレクトリ作ってなかった
失敗した原因
dotnet buildしてなかた
失敗した原因
<GenerateDocumentationFile>をfsprojに入れてなかった
失敗した原因
<GenerateDocumentationFile>を入れてdotnet buildしてなかったfsdocs難しすぎる・・・
(ドキュメントちゃんと読まずにやってる俺が悪い
やっと成功したっぽい
Write API Docs:
Generating output\reference/index.html
Generating output\reference/mt19937ar.html
Generating output\reference/mt19937ar-immutable.html
Generating output\reference/mt19937ar-module.html
Generating output\reference/mt19937ar-mutable.html
Generating output\reference/mt19937ar-type.html
Generating output\reference/mt19937ar-immutable-mersennetwister.html
Generating output\reference/mt19937ar-module-mersennetwister.html
Generating output\reference/mt19937ar-mutable-mersennetwister.html
Generating output\reference/mt19937ar-type-immutable.html
Generating output\reference/mt19937ar-type-mutable.html
Generating output\reference/mt19937ar-mersennetwister.html
Generating output\reference/mt19937ar-type-immutable-mersennetwister.html
Generating output\reference/mt19937ar-type-mutable-mersennetwister.htmlうん、fsdocsの構成
求めている方向性と違うので
fsdocsは却下だわ・・・おそらく
求めてる方向性に持っていこうとするなら
テンプレートを用意する必要があり
ソレは面倒いあ、テンプレート使って何がどう挿入されるのか分からんが・・・
デフォルトのだと生成されるhtml内のリンクが全部ルートからの絶対パスになっているぽくて
適当なディレクトリに置いてアクセスするとリンクが全部死ぬ- (UPD ) #
その点、DocFXは相対パスになっているぽいのでディレクトリに置いてもアクセスはできる(が、F#には対応してないため、dllから作るとC#なAPIリファレンスになる・・・
詰みです
これを設定すれば相対パスになる・・・?
- (UPD ) #
相対パスにはならなそう
絶対パスだこれ
絶対パスのルートを好きにできるというだけ・・・
これは手元チェック時と鯖アップロードとでパスが違うとそれぞれ別々にパスを設定する必要が・・・ひとまず
<PackageProjectUrl>./
</PackageProjectUrl>
を入れて試してみるか・・・?-parametersでコマンドラインで渡すほうがいいのか・・・?
./だとおかしなことになるな・・・
/docs/docproject/fs/mt19937ar_fs/Mt19937ar/output/reference/index.html
index.html内のリンクは
/docs/docproject/fs/mt19937ar_fs/Mt19937ar/output/reference/reference/mt19937ar-immutable.html
inwardlyから見た正しいパスは・・・
/docs/docproject/fs/mt19937ar_fs/Mt19937ar/output/reference/mt19937ar-immutable.htmlfsdocs build --parameters root "../"
で解決・・・したと思う・・・たぶんな
Source on GitHubじゃねーんだわ・・・ソースはbitbucketにあるんだわ・・・
つか、これのリンクURLもちげえし・・・fsdocs
改めて、却下だわ・・・・
Issue投げるか迷う
何せ困ってない(俺は)これ、メッセージが”テストプロジェクトっぽい”って表現になってるの
テストプロジェクトじゃないものも引っかかる可能性をちゃんと開発者は理解してるってことだな
トラブルが生じてから対応する(というよりプルリク投げろってことなのかもしれない・・・
この条件満たしているように見えないけど
for exampleだし他にも条件が・・・?- (UPD ) #
これproject name containsになっているけど、実際はproject path containsだよな・・・