Hugo+academicでの編集場所と編集方法（マークダウンの書き方）がわからない。

Question

したいこと

できるだけhtmlを書かずにポートフォリオを作ろと思ってhugo+academicを触っていたが、いざ自分のスキルや経歴を書くとなった時、どのようにMarkdownで編集すればいいかわからなくなった...
特に#したらコメントになってしまうところとか

環境

wsl
hugo:linux_extended_64bit
hugo version: Hugo Static Site Generator v0.69.2-EC9DCF30/extended linux/amd64 BuildDate: 2020-04-24T07:57:53Z

現在の状況

こんな感じでアイコン画像と、スキル欄が空欄である。

質問01

・写真アイコンのアップロードについて
現状：default画像はできるが任意の画像がアップロードできない
content/authors/adminの中では_index.mdと標準でavator.jpgがおいてあり、これをほかの画像にすることで
アイコンをアップロードしたい。
・default画像

・変更したい画像

###試したこと
画像の拡張子の変更や画像サイズを正方形に変更したがダメでした。
これをどうにか解消してほしいです。
他にも、、

content/author/admin
```の中にavatar.jpgを配置したり

static/img/

のなかにavatar.jpgを配置したりしましたがだめそうです。
この画像以外を配置できないでしょうか？？

###よろしくお願いします。
以上のような質問について、お答えしていただけると幸いです。
至らない点がありましたら教えていただきたいです。
よろしくお願いします。

Answer 1

念の為、hugo のバージョンを追記しておいてください。

hugo version
Hugo Static Site Generator v0.69.0 ← だと安定版の最新です。

アバター画像の差し替えは Introduce yourself にあるように、content/authors/admin/ 配下の avatar.png|jpgを差し替えてください。

png または jpg であれば対応しているはずです。
また、正方形でなくても問題ないはずですが、念の為ドキュメント通り正方形の画像にしておくのが無難です。
hugo server で立ち上げていれば、画像が live update されます。

ただ、ここまでは多分やってるんですよね＾＾；

画像が正しく処理されていれば、
resources/_gen/images/authors/admin/
にキャッシュが作られます。
そちらの正方形の画像ができているか確認してください。
ファイル名はハッシュ化されているので、よくわからないものになっていると思います。

あとは、
themes/academic/exampleSite/content/authors/admin/avatar.jpg
を変更しようとしてるとかではないですよね？

とりあえず、思いつくままですが、切り分けてみてください。

余談

いざ自分のスキルや経歴を書くとなった時、どのようにMarkdownで編集すればいいかわからなくなった...

特に#したらコメントになってしまうところとか

.md ファイルの+++とか---で囲まれた範囲は、ファイルの変数を置く場所なので、markdown は使用できません。

Front Matter

Comments

[oinari03]

ありがとうございます！！
問題としては、avatar.jpgの画像サイズが写真の編集のところで正方形ではなかったことでした。（感覚として正方形に近いサイズでペイントで編集していたので）
また、マークダウンの書き方についても教えていただきありがとうございます。

[退会済みユーザー]

解決したみたいで良かったです。

> avatar.jpgの画像サイズが写真の編集のところで正方形ではなかったことでした。

うちの環境では、正方形でなくてもうまくいったんですけど、もしかするとバージョンが関係しているかもしれないですね。

後から見る人のためにも、hugo version の結果を質問には追記しておいてください。