Update posts directory
This commit is contained in:
Cassidy Williams
@@ -1,103 +0,0 @@
|
|||||||
---
|
|
||||||
layout: "../../layouts/BlogPost.astro"
|
|
||||||
title: "Markdown Style Guide"
|
|
||||||
description: "Here is a sample of some basic Markdown syntax that can be used when writing Markdown content in Astro."
|
|
||||||
added: "Jul 01 2022"
|
|
||||||
heroImage: "/placeholder-hero.jpg"
|
|
||||||
---
|
|
||||||
|
|
||||||
Here is a sample of some basic Markdown syntax that can be used when writing Markdown content in Astro.
|
|
||||||
|
|
||||||
## Headings
|
|
||||||
|
|
||||||
The following HTML `<h1>`—`<h6>` elements represent six levels of section headings. `<h1>` is the highest section level while `<h6>` is the lowest.
|
|
||||||
|
|
||||||
# H1
|
|
||||||
## H2
|
|
||||||
### H3
|
|
||||||
#### H4
|
|
||||||
##### H5
|
|
||||||
###### H6
|
|
||||||
|
|
||||||
## Paragraph
|
|
||||||
|
|
||||||
Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.
|
|
||||||
|
|
||||||
Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.
|
|
||||||
|
|
||||||
## Images
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Blockquotes
|
|
||||||
|
|
||||||
The blockquote element represents content that is quoted from another source, optionally with a citation which must be within a `footer` or `cite` element, and optionally with in-line changes such as annotations and abbreviations.
|
|
||||||
|
|
||||||
#### Blockquote without attribution
|
|
||||||
|
|
||||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
|
|
||||||
> **Note** that you can use *Markdown syntax* within a blockquote.
|
|
||||||
|
|
||||||
#### Blockquote with attribution
|
|
||||||
|
|
||||||
> Don't communicate by sharing memory, share memory by communicating.<br>
|
|
||||||
> — <cite>Rob Pike[^1]</cite>
|
|
||||||
|
|
||||||
[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) during Gopherfest, November 18, 2015.
|
|
||||||
|
|
||||||
## Tables
|
|
||||||
|
|
||||||
| Italics | Bold | Code |
|
|
||||||
| -------- | -------- | ------ |
|
|
||||||
| *italics* | **bold** | `code` |
|
|
||||||
|
|
||||||
## Code Blocks
|
|
||||||
|
|
||||||
```html
|
|
||||||
<!doctype html>
|
|
||||||
<html lang="en">
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<title>Example HTML5 Document</title>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<p>Test</p>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
```
|
|
||||||
|
|
||||||
## List Types
|
|
||||||
|
|
||||||
#### Ordered List
|
|
||||||
|
|
||||||
1. First item
|
|
||||||
2. Second item
|
|
||||||
3. Third item
|
|
||||||
|
|
||||||
#### Unordered List
|
|
||||||
|
|
||||||
* List item
|
|
||||||
* Another item
|
|
||||||
* And another item
|
|
||||||
|
|
||||||
#### Nested list
|
|
||||||
|
|
||||||
* Fruit
|
|
||||||
* Apple
|
|
||||||
* Orange
|
|
||||||
* Banana
|
|
||||||
* Dairy
|
|
||||||
* Milk
|
|
||||||
* Cheese
|
|
||||||
|
|
||||||
## Other Elements — abbr, sub, sup, kbd, mark
|
|
||||||
|
|
||||||
<abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format.
|
|
||||||
|
|
||||||
H<sub>2</sub>O
|
|
||||||
|
|
||||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
|
||||||
|
|
||||||
Press <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd></kbd> to end the session.
|
|
||||||
|
|
||||||
Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.
|
|
||||||
@@ -1,32 +0,0 @@
|
|||||||
---
|
|
||||||
layout: '../../layouts/BlogPost.astro'
|
|
||||||
title: 'Using MDX'
|
|
||||||
description: 'Lorem ipsum dolor sit amet'
|
|
||||||
added: 'Jul 02 2022'
|
|
||||||
heroImage: '/placeholder-hero.jpg'
|
|
||||||
---
|
|
||||||
|
|
||||||
This theme comes with the [@astrojs/mdx](https://docs.astro.build/en/guides/integrations-guide/mdx/) integration installed and configured in your `astro.config.mjs` config file. If you prefer not to use MDX, you can disable support by removing the integration from your config file.
|
|
||||||
|
|
||||||
## Why MDX?
|
|
||||||
|
|
||||||
MDX is a special flavor of Markdown that supports embedded JavaScript & JSX syntax. This unlocks the ability to [mix JavaScript and UI Components into your Markdown content](https://docs.astro.build/en/guides/markdown-content/#mdx-features) for things like interactive charts or alerts.
|
|
||||||
|
|
||||||
If you have existing content authored in MDX, this integration will hopefully make migrating to Astro a breeze.
|
|
||||||
|
|
||||||
## Example
|
|
||||||
|
|
||||||
Here is how you import and use a UI component inside of MDX.
|
|
||||||
When you open this page in the browser, you should see the clickable button below.
|
|
||||||
|
|
||||||
import HeaderLink from '../../components/HeaderLink.astro';
|
|
||||||
|
|
||||||
<HeaderLink href="#" onclick="alert('clicked!')">
|
|
||||||
Embedded component in MDX
|
|
||||||
</HeaderLink>
|
|
||||||
|
|
||||||
## More Links
|
|
||||||
|
|
||||||
- [MDX Syntax Documentation](https://mdxjs.com/docs/what-is-mdx)
|
|
||||||
- [Astro Usage Documentation](https://docs.astro.build/en/guides/markdown-content/#markdown-and-mdx-pages)
|
|
||||||
- **Note:** [Client Directives](https://docs.astro.build/en/reference/directives-reference/#client-directives) are still required to create interactive components. Otherwise, all components in your MDX will render as static HTML (no JavaScript) by default.
|
|
||||||
@@ -14,7 +14,7 @@ So, I’ve helped as a peer mentor, as an impromptu tutor, as a friend, and just
|
|||||||
|
|
||||||
As both an asker and a helper, I’ve discovered the best techniques for asking for help, that will actually get you help.
|
As both an asker and a helper, I’ve discovered the best techniques for asking for help, that will actually get you help.
|
||||||
|
|
||||||
##First: Actually try something.
|
## First: Actually try something.
|
||||||
|
|
||||||
People who you’re asking will be giving you help, not a solution.
|
People who you’re asking will be giving you help, not a solution.
|
||||||
The first thing someone will probably ask you is “What have you tried?”
|
The first thing someone will probably ask you is “What have you tried?”
|
||||||
@@ -22,7 +22,7 @@ If your answer amounts to “not a lot”, they have a perfect excuse to flat ou
|
|||||||
If you try something, then you show that you’re at least moderately familiar with your problem, that you know what won’t work, and it’ll give the helper a guide for how they could explain something to you.
|
If you try something, then you show that you’re at least moderately familiar with your problem, that you know what won’t work, and it’ll give the helper a guide for how they could explain something to you.
|
||||||
If you’re totally lost on what to try, search for your problem online to get some familiarity.
|
If you’re totally lost on what to try, search for your problem online to get some familiarity.
|
||||||
|
|
||||||
##Narrow down your problem.
|
## Narrow down your problem.
|
||||||
|
|
||||||
If you know that just one part of the problem is your issue (because you tried something), make sure you tell your helper (this sounds like I’m talking about some sort of designated buddy system... anyway...) what that small part is.
|
If you know that just one part of the problem is your issue (because you tried something), make sure you tell your helper (this sounds like I’m talking about some sort of designated buddy system... anyway...) what that small part is.
|
||||||
Now, don’t show them something so small that they can’t help you at all, but give them something fairly small to work with.
|
Now, don’t show them something so small that they can’t help you at all, but give them something fairly small to work with.
|
||||||
@@ -30,7 +30,7 @@ If it’s a coding problem, chances are they won’t want to go through 10,000 l
|
|||||||
If it’s a math problem, they probably don’t need to see ALL of your steps getting to where you’re at. Et cetera.
|
If it’s a math problem, they probably don’t need to see ALL of your steps getting to where you’re at. Et cetera.
|
||||||
I mean sure, be able to describe the larger context of your problem, but then focus on your problem area when you’re asking for help.
|
I mean sure, be able to describe the larger context of your problem, but then focus on your problem area when you’re asking for help.
|
||||||
|
|
||||||
##Don’t be a lazy recipient.
|
## Don’t be a lazy recipient.
|
||||||
|
|
||||||
When someone is helping you, they’re donating their time and effort into making sure you understand something.
|
When someone is helping you, they’re donating their time and effort into making sure you understand something.
|
||||||
Don’t sit there on your phone while they look at your screen or read your paper.
|
Don’t sit there on your phone while they look at your screen or read your paper.
|
||||||
Reference in New Issue
Block a user