Astro - Revision history

KazVee: Add Tutorials category tag to the page

2025-07-13T03:34:16Z

Add Tutorials category tag to the page

← Older revision		Revision as of 03:34, 13 July 2025
Line 293:		Line 293:

	If you cannot view your published site after following the above steps, please go back and check every step again to make sure nothing was missed. After doing this, if you are still stuck, please check your account [[:View_Error_Logs \| error logs]], since these will often provide information that can help you resolve the problem. If you're still not sure how to fix the issue, please feel free to post a new topic in the [https://helionet.org/index/forum/45-customer-service/?do=add Customer Support forum]. Make sure you provide your hosting account '''username''' and details of the problem, including any '''error messages''' received.		If you cannot view your published site after following the above steps, please go back and check every step again to make sure nothing was missed. After doing this, if you are still stuck, please check your account [[:View_Error_Logs \| error logs]], since these will often provide information that can help you resolve the problem. If you're still not sure how to fix the issue, please feel free to post a new topic in the [https://helionet.org/index/forum/45-customer-service/?do=add Customer Support forum]. Make sure you provide your hosting account '''username''' and details of the problem, including any '''error messages''' received.

			[[Category:Tutorials]]

KazVee: Add link to view Error Logs

2025-04-20T23:28:27Z

Add link to view Error Logs

← Older revision		Revision as of 23:28, 20 April 2025
Line 292:		Line 292:
	== Further Support ==		== Further Support ==

	If you cannot view your published site after following the above steps, please go back and check every step again to make sure nothing was missed. After doing this, if you are still stuck, please feel free to post a new topic in the [https://helionet.org/index/forum/45-customer-service/?do=add Customer Support forum]. Make sure you provide your hosting account '''username''' and details of the problem, including any '''error messages''' received.		If you cannot view your published site after following the above steps, please go back and check every step again to make sure nothing was missed. After doing this, if you are still stuck, please check your account [[:View_Error_Logs \| error logs]], since these will often provide information that can help you resolve the problem. If you're still not sure how to fix the issue, please feel free to post a new topic in the [https://helionet.org/index/forum/45-customer-service/?do=add Customer Support forum]. Make sure you provide your hosting account '''username''' and details of the problem, including any '''error messages''' received.

KazVee: Add missing word

2025-04-06T01:56:50Z

Add missing word

← Older revision		Revision as of 01:56, 6 April 2025
Line 276:		Line 276:
	* Stop your development environment in the terminal with '''Ctrl + C''' and then answer '''Yes''' to stop the batch job		* Stop your development environment in the terminal with '''Ctrl + C''' and then answer '''Yes''' to stop the batch job
	* Build your updated site by typing <code>npm run build</code> into the terminal window		* Build your updated site by typing <code>npm run build</code> into the terminal window
	* Upload the entire contents Astro's '''dist''' folder into your '''httpdocs''' folder in Plesk on your HelioHost account		* Upload the entire contents of Astro's '''dist''' folder into your '''httpdocs''' folder in Plesk on your HelioHost account

	== Further Self-Learning ==		== Further Self-Learning ==

KazVee: Update to use new screenshot filenames for items used by multiple tutorials (Astro & Gatsby)

2025-04-05T18:58:05Z

Update to use new screenshot filenames for items used by multiple tutorials (Astro & Gatsby)

← Older revision		Revision as of 18:58, 5 April 2025
Line 59:		Line 59:
	Change the terminal type from 'PowerShell' to 'Command Prompt' by clicking on the little down arrow on the right side of the terminal to open the selection menu and choose 'Command Prompt'.		Change the terminal type from 'PowerShell' to 'Command Prompt' by clicking on the little down arrow on the right side of the terminal to open the selection menu and choose 'Command Prompt'.

	[[File:~~Astro-change~~-terminal-type.png]]		[[File:Change-terminal-type.png]]

	You should see the 'cmd' terminal line highlighted, confirming it is active and selected.		You should see the 'cmd' terminal line highlighted, confirming it is active and selected.

	[[File:~~Astro-confirm~~-cmd-terminal-selected.png]]		[[File:Confirm-cmd-terminal-selected.png]]

	=== Confirm that Node.js is Installed ===		=== Confirm that Node.js is Installed ===
Line 72:		Line 72:
	If Node.js has been installed correctly, you should see a message confirming the Node version number:		If Node.js has been installed correctly, you should see a message confirming the Node version number:

	[[File:~~Astro-check~~-node-version.png]]		[[File:Check-node-version.png]]

	== Create a New Astro Site ==		== Create a New Astro Site ==
Line 116:		Line 116:
	Go back into VS Code and click on the square 'Explorer' button, and then click on the blue 'Open Folder' button.		Go back into VS Code and click on the square 'Explorer' button, and then click on the blue 'Open Folder' button.

	[[File:~~Astro-vscode~~-open-folder.png]]		[[File:Vscode-open-folder.png]]

	== Find and Open the Astro Site Folder ==		== Find and Open the Astro Site Folder ==
Line 122:		Line 122:
	Locate the 'my-blog' folder (or whatever you named yours) on your machine, click on the folder once to highlight it, and then click on the 'Select Folder' button to open it in VS Code.		Locate the 'my-blog' folder (or whatever you named yours) on your machine, click on the folder once to highlight it, and then click on the 'Select Folder' button to open it in VS Code.

	[[File:~~Astro-vscode~~-select-folder.png]]		[[File:Vscode-select-folder.png]]

	You may see a popup window asking 'Do you trust the authors of the files in this folder?'. Click on the blue 'Yes, I trust the authors' button.		You may see a popup window asking 'Do you trust the authors of the files in this folder?'. Click on the blue 'Yes, I trust the authors' button.

	[[File:~~Astro-vscode~~-trust-authors.png]]		[[File:Vscode-trust-authors.png]]

	You may see a popup window asking 'Do you want to install the recommended extensions from Astro and unified for this repository?'. Click the 'X' to close the suggestion window. (We do not need the extensions to follow this tutorial, but it's not a problem if you decide to install them.)		You may see a popup window asking 'Do you want to install the recommended extensions from Astro and unified for this repository?'. Click the 'X' to close the suggestion window. (We do not need the extensions to follow this tutorial, but it's not a problem if you decide to install them.)
Line 144:		Line 144:
	As we did earlier, change the Terminal type again from 'PowerShell' to 'Command Prompt' by clicking on the little down arrow on the right side of the terminal to open the selection menu and choose 'Command Prompt'.		As we did earlier, change the Terminal type again from 'PowerShell' to 'Command Prompt' by clicking on the little down arrow on the right side of the terminal to open the selection menu and choose 'Command Prompt'.

	[[File:~~Astro-change~~-terminal-type.png]]		[[File:Change-terminal-type.png]]

	Once again, you should see the cmd terminal line highlighted, confirming it is active and selected.		Once again, you should see the cmd terminal line highlighted, confirming it is active and selected.

	[[File:~~Astro-confirm~~-cmd-terminal-selected.png]]		[[File:Confirm-cmd-terminal-selected.png]]

	In the cmd terminal window, enter the command <code>npm run dev</code> to start Astro running again on your local machine.		In the cmd terminal window, enter the command <code>npm run dev</code> to start Astro running again on your local machine.

KazVee: Update Node screenshot link

2025-04-05T18:47:32Z

Update Node screenshot link

← Older revision		Revision as of 18:47, 5 April 2025
Line 36:		Line 36:
	During the Node.js install process, you may be asked about installing 'Tools for Native Modules'. You can leave the checkbox '''unchecked''' and click on the 'Next' button.		During the Node.js install process, you may be asked about installing 'Tools for Native Modules'. You can leave the checkbox '''unchecked''' and click on the 'Next' button.

	[[File:~~Astro-node~~-tools-for-native-modules.png]]		[[File:Node-tools-for-native-modules.png]]

	=== Nice to Have ===		=== Nice to Have ===

KazVee: Fix phrasing

2025-03-03T16:12:41Z

Fix phrasing

← Older revision		Revision as of 16:12, 3 March 2025
Line 189:		Line 189:
	</pre>		</pre>

	What the error message means is that Astro is expecting a 1) title, 2) description, and 3) pubDate (publication date) inside our new file. When Astro is running, it continually monitors all your project files. When we created the empty hello-world.md file, it have the contents Astro expected, so it threw an error.		What the error message means is that Astro is expecting a 1) title, 2) description, and 3) pubDate (publication date) inside our new file. When Astro is running, it continually monitors all your project files. When we created the empty hello-world.md file, it did not have the contents Astro expected, so it threw an error.

	'''Optional:''' Have a look at the top sections of the existing files inside the '''src/content/blog''' folder for some examples of the details Astro expects at the top of blog post files.		'''Optional:''' Have a look at the top sections of the existing files inside the '''src/content/blog''' folder for some examples of the details Astro expects at the top of blog post files.

KazVee: Improve phrasing & fix punctuation

2025-03-03T16:08:36Z

Improve phrasing & fix punctuation

← Older revision		Revision as of 16:08, 3 March 2025
Line 170:		Line 170:
	[[File:Astro-vscode-new-file.png]]		[[File:Astro-vscode-new-file.png]]

	Name the new file '''hello-world.md'''.		Name the new file '''hello-world.md'''

	'''Note:''' '.md' files are Markdown files. You do not need to know Markdown syntax to follow this tutorial, but Astro offers a helpful [https://codeview.astro.new/blog/blog/markdown-style-guide/ Markdown Style Guide] if you want to learn more about ~~how to customize~~ your site with bold or italic text or to insert headers, images, or web links.		'''Note:''' '.md' files are Markdown files. You do not need to know Markdown syntax to follow this tutorial, but Astro offers a helpful [https://codeview.astro.new/blog/blog/markdown-style-guide/ Markdown Style Guide] if you want to learn more about customizing your site with bold or italic text or how to insert headers, images, or web links.

	== Astro Detected an Unhandled Rejection ==		== Astro Detected an Unhandled Rejection ==

KazVee: Fix phrasing

2025-03-03T16:00:38Z

Fix phrasing

← Older revision		Revision as of 16:00, 3 March 2025
Line 120:		Line 120:
	== Find and Open the Astro Site Folder ==		== Find and Open the Astro Site Folder ==

	Locate the 'my-blog' folder (or whatever you named yours) on your machine, click on the folder once to highlight it, and then click on the 'Select Folder' button to open it.		Locate the 'my-blog' folder (or whatever you named yours) on your machine, click on the folder once to highlight it, and then click on the 'Select Folder' button to open it in VS Code.

	[[File:Astro-vscode-select-folder.png]]		[[File:Astro-vscode-select-folder.png]]

KazVee: Improve phrasing

2025-03-03T16:00:05Z

Improve phrasing

← Older revision		Revision as of 16:00, 3 March 2025
Line 120:		Line 120:
	== Find and Open the Astro Site Folder ==		== Find and Open the Astro Site Folder ==

	Locate the 'my-blog' folder (or whatever you named yours) on your machine, click the folder to highlight it, and then click on the 'Select Folder' button to open it.		Locate the 'my-blog' folder (or whatever you named yours) on your machine, click on the folder once to highlight it, and then click on the 'Select Folder' button to open it.

	[[File:Astro-vscode-select-folder.png]]		[[File:Astro-vscode-select-folder.png]]

KazVee: Improve phrasing

2025-03-03T15:59:32Z

Improve phrasing

← Older revision		Revision as of 15:59, 3 March 2025
Line 114:		Line 114:
	== Editing the Astro Site ==		== Editing the Astro Site ==

	Go back into VS Code and click on the square 'Explorer' button~~. Click~~ on the blue 'Open Folder' button.		Go back into VS Code and click on the square 'Explorer' button, and then click on the blue 'Open Folder' button.

	[[File:Astro-vscode-open-folder.png]]		[[File:Astro-vscode-open-folder.png]]