usakdsteen

ゆうさくですてぃーん

2021年10月18日(Mon)の独り言

の呟きは 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というサイトの特権みたいな感じ・・?

              •  #

                皆が自由勝手に配布するのも
                まぁ大変な部分はあるが

            •  #

              どうなんだ・・・?

              f:id:neetsdkasu:20211018155026p:plain
              •  #

                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冊あたりが安くなってしまうのかもしれない・・・

      •  (UPD ) #

        ただ、
        最寄のブックオフが片道4kmであり

        チャリでキツかった・・・
        正直、体力の衰え・・・
        あのブックオフからさらに2km進んだ先に俺のチャリ通学していた高校があるわけで・・・その高校よりブックオフは2kmも近いわけで・・・
        つまり、高校生のときよりかなーーーーーーり体力も筋力も衰えている・・・

        •  (UPD ) #

          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リファレンスになる・・・

                    •  #

                      詰みです

                  •  #

                    これを設定すれば相対パスになる・・・?

                    f:id:neetsdkasu:20211018222729p:plain
                    •  (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.html

                          •  #

                            fsdocs build --parameters root "../"

                            で解決・・・したと思う・・・たぶんな

                            •  #

                              一応相互内リンクが有効になったっぽくて
                              一部の画像やスクリプト(?)が動くようになったっぽい

                              ただ、おかしいぽいところはまだ残っているが・・

                              •  #

                                画像リンクのパスが一部壊れてる・・・"../"の影響か・・・

                                /docs/docproject/fs/mt19937ar_fs/Mt19937ar/output/img/logo.png

                                /docs/docproject/fs/mt19937ar_fs/Mt19937ar/output/content/img/github-hover.png

                                •  #

                                  つまり
                                  相対パス
                                  やはりダメ

                                •  #

                                  ほかもいくつかリンクが壊れているっぽい・・・

              •  #

                Source on GitHubじゃねーんだわ・・・ソースはbitbucketにあるんだわ・・・

                つか、これのリンクURLもちげえし・・・

                f:id:neetsdkasu:20211018232800p:plain
                •  (UPD ) #

                  なんか色々ダメ・・・


                  リンク崩壊

                  •  #

                    github前提だったり

                    これダメだわ・・・

                    •  #

                      オンラインリポジトリへのリンクが全部github前提のパス構成になってる・・・

                      •  #

                        (要するに、github以外への対応欲しいならプルリクしろってことぽそう

              •  #

                fsdocs
                改めて、却下だわ・・・・

  •  #

    Issue投げるか迷う

    何せ困ってない(俺は)

    •  #

      これ、メッセージが”テストプロジェクトっぽい”って表現になってるの
      テストプロジェクトじゃないものも引っかかる可能性をちゃんと開発者は理解してるってことだな
      トラブルが生じてから対応する(というよりプルリク投げろってことなのかもしれない・・・

  •  #

    この条件満たしているように見えないけど
    for exampleだし他にも条件が・・・?

    f:id:neetsdkasu:20211017223759p:plain
    •  (UPD ) #

      これproject name containsになっているけど、実際はproject path containsだよな・・・

 < の独り言 | の独り言 | の独り言 >