Tutorials

Tutorial articles for Hugo Connectome Theme

Introduction: Connectome Tutorials

How to Use

Published:
Summary: Load the themes in a folder inside themes. Read the docs by Hugo for more details. Use the config.yaml file in the exampleSite folder.
Pages: 9

8 Command Palette

Published:
Summary: To use the command palette, press Command+ k(on Mac) or Windows+ k(on Windows). There are some generic commands we can use on every page, e.g., Home: navigate back to home page, View Graph: navigate to the graph page, All Notebooks: navigate to the notebook list, Search: search notes by title, which is less powerful than the search bar on the home page. On note pages, we can use note specific commands, e.
Pages: 9

7 Adding References

Published:
Summary: One could also add references to the post. Just add the following to the meta data of the post. references: - name: "Hugo (This is a demo reference)" link: "https://gohugo.com" The result is shown on the right. Inline citation of a reference is also possible if we give the reference a key. references: - name: "Hugo (This is a demo reference)" link: "https://gohugo.com" key: "hugo" And in text, do the following
Pages: 9

6 Embed Articles

Published:
Summary: Embed an article using the shortcode
Pages: 9

5 Link to Another Page and Show Hovercard

Published:
Summary: Apart from the normal markdown links, e.g., [this link](snm/single-neuron-model) we can also link to other page using the following code. {{< c "tutorials/embed-articles.md" >}} The result will be this: [[Embed Articles]] Embed Articles Embed an article using the shortcode . By hovering on this link, a preview of the summary of the target post. Do not Ignore the Spaces Please make sure the is at least one space between the different components of the shortcode.
Pages: 9

4 Link Articles

Published:
Summary: There are three different ways to link notes: use links in the note metadata, this will be covered in the current note, use shortcode c to add a hyperlink in the texts, see [[Link to Another Page and Show Hovercard]] Link to Another Page and Show Hovercard Apart from the normal markdown links, e.g., [this link](snm/single-neuron-model) we can also link to other page using the following code. {{< c "tutorials/embed-articles.
Pages: 9

3 Upvote Button at the Bottom of the Page

Published:
Summary: The small upvote and downvote nav buttons at the bottom right of the page are make with lyket. Optional This step is optional. It is up to the user to decide whether to configure a upvote or not. This is a demo configuration. lyket: api_key: "xxbadsjflkdjwe" lyket_type: "updown" To get the api token, sign up and copy the API token.
Pages: 9

2 Comments

Published:
Summary: Hugo connectome supports two comment systems: utteranc.es, and giscus. Optional This step is optional. It is up to the user to decide whether to configure a comment system or not. Here is a demo config. We put both giscus and utterances here but we only use: "giscus". comments: use: "giscus" giscus: repo: "datumorphism/comments" repo_id: "MDEwOlJlcG9zaXRvcnkxNjU5MDkyNDI=" category: "Comments" category_id: "DIC_kwDOCeOS-s4B-Zxx" utterances: # comment system: utterances (https://utteranc.es/) parameters repo: "datumorphism/comments" # repo="[ENTER REPO HERE]", the comments will appear as issues in this repository on github.
Pages: 9

1 Graph of Connected Articles

Published:
Summary: All articles that are connected by [[using links in metadata]] Link Articles There are three different ways to link notes: use links in the note metadata, this will be covered in the current note, use shortcode c to add a hyperlink in the texts, see [[Link to Another Page and Show Hovercard]] Link to Another Page and Show Hovercard Apart from the normal markdown links, e.g., [this link](snm/single-neuron-model) we can also link to other page using the following code.
Pages: 9