You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 10/umbraco-cms/extending/filesystemproviders/azure-blob-storage.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ The correct package will have be installed in your project.
44
44
45
45
## Configuring Blob storage
46
46
47
-
The next step is to configure your blob storage. There are multiple approaches for this, but in this document, we're going to do it through `appsettings.json`. For more configuration options, see the [readme](https://github.com/umbraco/Umbraco.StorageProviders#umbracostorageproviders) on the Github repository.
47
+
The next step is to configure your blob storage. There are multiple approaches for this, but in this document, we're going to do it through `appsettings.json`. For more configuration options, see the [readme](https://github.com/umbraco/Umbraco.StorageProviders#umbracostorageproviders) on the GitHub repository.
48
48
49
49
Open up your `appsettings.json` file and add the connection string and container name under `Umbraco:Storage:AzureBlob:Media`. Your Umbraco section of appsettings will look something like this:
| Version | 1.0.0 | This is automatically set to 1.0.0 but can be changed as appropriate. |
149
149
| Authors | Your name | Here you get to take credit for your awesome work! |
150
-
| PackageProjectUrl |https://umbraco.com| This URL will be shown as the package's URL when others install it. It will likely be a Github repository, or similar. |
150
+
| PackageProjectUrl |https://umbraco.com| This URL will be shown as the package's URL when others install it. It will likely be a GitHub repository, or similar. |
151
151
| PackageLicenseExpression | MIT | The license is set to MIT. Please consider how you want your package licensed. If in doubt when deciding an open-source license there are [good resources available](https://choosealicense.com/licenses/). |
Copy file name to clipboardExpand all lines: 10/umbraco-cms/extending/packages/example-package-repository.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ Finally there's an [example Umbraco website](https://github.com/umbraco/Umbraco.
44
44
45
45
As well as the projects, the following files are added to the solution:
46
46
47
-
-[.artifactignore](https://github.com/umbraco/Umbraco.AuthorizedServices/blob/main/.artifactignore) - used by AzureDevOps services to [control which files are uploaded when you publish](https://learn.microsoft.com/en-us/azure/devops/artifacts/reference/artifactignore?view=azure-devops). This helps to reduce pipeline execution time.
47
+
-[.artifactignore](https://github.com/umbraco/Umbraco.AuthorizedServices/blob/main/.artifactignore) - used by Azure DevOps services to [control which files are uploaded when you publish](https://learn.microsoft.com/en-us/azure/devops/artifacts/reference/artifactignore?view=azure-devops). This helps to reduce pipeline execution time.
48
48
-[.editorconfig](https://github.com/umbraco/Umbraco.AuthorizedServices/blob/main/.editorconfig) - used to [enforce consistent coding styles](https://editorconfig.org/) for multiple developers working on the same project across editors and IDEs.
49
49
-[.gitignore](https://github.com/umbraco/Umbraco.AuthorizedServices/blob/main/.gitignore) - controls which files are added to source control.
50
50
-[.globalconfig](https://github.com/umbraco/Umbraco.AuthorizedServices/blob/main/.globalconfig) - provides [further styling rules for the project files, even if stored outside of the project directory](https://learn.microsoft.com/en-us/dotnet/fundamentals/code-analysis/configuration-files#global-analyzerconfig).
@@ -58,7 +58,7 @@ As well as the projects, the following files are added to the solution:
58
58
59
59
## Build and Deployment
60
60
61
-
We use AzureDevOps pipelines for continuous integration and releasing new versions of the package. The definition of how the project is built is defined in a `.yaml` file that's part of the source code repository.
61
+
We use Azure DevOps pipelines for continuous integration and releasing new versions of the package. The definition of how the project is built is defined in a `.yaml` file that's part of the source code repository.
62
62
63
63
The file can be found [here](https://github.com/umbraco/Umbraco.AuthorizedServices/blob/main/azure-pipeline%20-%20Umbraco.AuthorizedServices.yml).
64
64
@@ -68,13 +68,13 @@ Even if using another tool it may be worth reviewing how we have setup our pipel
68
68
69
69
The build consists of two stages: building the solution and running unit tests. Only if both succeed is the build as a whole considered successful.
We release the package manually in AzureDevOps, with a two stage process. Firstly we release to a "pre-releases" feed, and then after manual approval, to NuGet.
75
+
We release the package manually in Azure DevOps, with a two stage process. Firstly we release to a "pre-releases" feed, and then after manual approval, to NuGet.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/extending/ui-library.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ You can also change the stylesheet of custom properties to see how the component
24
24
25
25
## Installing the UI Library Components
26
26
27
-
You can download the UI Library package from [Github](https://github.com/umbraco/Umbraco.UI/tree/v1/contrib/packages).
27
+
You can download the UI Library package from [GitHub](https://github.com/umbraco/Umbraco.UI/tree/v1/contrib/packages).
28
28
29
29
If you are installing a component via npm, there are two ways to import it:
30
30
@@ -40,7 +40,7 @@ If you are installing a component via npm, there are two ways to import it:
40
40
'@umbraco-ui/uui-button/lib/uui-button.element';
41
41
```
42
42
43
-
For more information on installation, Content Delivery Networks (CDN), or included components, see the [Readme file in the Github](https://github.com/umbraco/Umbraco.UI#readme) project.
43
+
For more information on installation, Content Delivery Networks (CDN), or included components, see the [Readme file in the GitHub](https://github.com/umbraco/Umbraco.UI#readme) project.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/reference/security/cookies.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,4 +33,4 @@ services.AddSession(options =>
33
33
});
34
34
```
35
35
36
-
For information on the rest of the cookies, see the [Constants-Web.cs](https://github.com/umbraco/Umbraco-CMS/blob/v10/contrib/src/Umbraco.Core/Constants-Web.cs) file on Github.
36
+
For information on the rest of the cookies, see the [Constants-Web.cs](https://github.com/umbraco/Umbraco-CMS/blob/v10/contrib/src/Umbraco.Core/Constants-Web.cs) file on GitHub.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/tutorials/creating-and-distributing-a-package.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,18 +12,18 @@ The content in this article is valid _only_ for Umbraco version 8. For Umbraco v
12
12
*[Creating a test site locally](creating-and-distributing-a-package.md#creating-a-test-site-locally)
13
13
*[Creating a package from the backoffice](creating-and-distributing-a-package.md#creating-a-package-from-the-backoffice)
14
14
*[Creating a draft package on Our](creating-and-distributing-a-package.md#creating-a-draft-package-on-our)
15
-
*[Pushing your package to Github](creating-and-distributing-a-package.md#pushing-your-package-to-github)
15
+
*[Pushing your package to GitHub](creating-and-distributing-a-package.md#pushing-your-package-to-github)
16
16
*[Pack up your package locally using UmbPack](creating-and-distributing-a-package.md#pack-up-your-package-locally-using-umbpack)
17
17
*[Pushing your package to Our using UmbPack](creating-and-distributing-a-package.md#pushing-your-package-to-our-using-umbpack)
18
-
*[Deploy your package using Github Actions](creating-and-distributing-a-package.md#deploy-your-package-using-github-actions)
18
+
*[Deploy your package using GitHub Actions](creating-and-distributing-a-package.md#deploy-your-package-using-github-actions)
19
19
*[Archive older versions on push](creating-and-distributing-a-package.md#archive-older-versions-on-push)
20
20
21
21
## Prerequisites
22
22
23
23
To run this tutorial you will need the following:
24
24
25
25
* Be able to run an Umbraco site locally
26
-
* Git + Github account
26
+
* Git + GitHub account
27
27
*[Our Umbraco member account](https://our.umbraco.com/member/Signup) with access to upload packages
28
28
* UmbPack installed
29
29
* Umbraco Package templates installed
@@ -60,7 +60,7 @@ It will show you all the options you have for creating a new Umbraco site + pack
60
60
dotnet new umbraco-v8-package -n PackageWorkshop -d
61
61
```
62
62
63
-
This will create a new package called `PackageWorkshop`, and add a custom Dashboard for us to use in this tutorial. By default you will also get a Github Action added that we will return to later.
63
+
This will create a new package called `PackageWorkshop`, and add a custom Dashboard for us to use in this tutorial. By default you will also get a GitHub Action added that we will return to later.
64
64
65
65
After running you will have a folder called `PackageWorkshop`, inside that you will have your site and solution files. So try to open it in Visual Studio or Rider by opening the `PackageWorkshop.sln` file.
66
66
@@ -234,13 +234,13 @@ Now your package is on Our, and if the "Go live" button is clicked it is visible
234
234
235
235
The next step is to make it a bit simpler to deploy updates to the package. It is perfectly fine to log in here and upload a new version each time. The next steps will show an easier way though.
236
236
237
-
## Pushing your package to Github
237
+
## Pushing your package to GitHub
238
238
239
239
If you are creating a package in order to share it with others it is a great idea to also share the source code. It is the open source way.
240
240
241
-
To share it, and make it easier to manage and deploy updates we will set up a Github repository for the package. This tutorial assumes you know what Github is, and that you have an account.
241
+
To share it, and make it easier to manage and deploy updates we will set up a GitHub repository for the package. This tutorial assumes you know what GitHub is, and that you have an account.
242
242
243
-
Create a fresh repo, with no readme, gitignore or license - do not choose a repository template (set to 'No Template'). On the second screen it will give you a command to push an existing repository to the new Github repo, should look like this but with your own user in the link:
243
+
Create a fresh repo, with no readme, gitignore or license - do not choose a repository template (set to 'No Template'). On the second screen it will give you a command to push an existing repository to the new GitHub repo, should look like this but with your own user in the link:
At this point you know how to create a package from the backoffice, upload it to Our and push your changes to Github. That's what it takes to create and maintain a package.
274
+
At this point you know how to create a package from the backoffice, upload it to Our and push your changes to GitHub. That's what it takes to create and maintain a package.
275
275
276
276
If you want to make changes and push a new version you can carry out the following steps:
277
277
278
278
* Create the new package in the backoffice
279
-
* Sync your code to Github
279
+
* Sync your code to GitHub
280
280
* Go to Our and upload a new zip version
281
281
* Set that to the current version
282
282
* Optionally archive the previous one
@@ -399,15 +399,15 @@ You can edit all of these defaults, and also specify older versions of your pack
399
399
400
400
So at this point we can work on our package locally, build a new version within seconds by running the pack command and then deploy it to Our using the push command.
401
401
402
-
Not easy enough for you? Let's try automating this entire thing with Github actions then.
402
+
Not easy enough for you? Let's try automating this entire thing with GitHub Actions then.
403
403
404
-
## Deploy your package using Github Actions
404
+
## Deploy your package using GitHub Actions
405
405
406
-
If you think back to the beginning when we set up our sites using the Package Templates you may remember that by default you get a Github action installed as well.
406
+
If you think back to the beginning when we set up our sites using the Package Templates you may remember that by default you get a GitHub action installed as well.
407
407
408
408
If you check out the `~/.github/workflows` folder in your solution, you will see there is a readme file and a build.yml file.
409
409
410
-
The build.yml file is used by Github actions, which will perform some tasks for you when certain criteria are met. If you haven't worked with continuous integration and deployment (CI/CD) before, then this may seem like magic - but don't worry we will run through the commands.
410
+
The build.yml file is used by GitHub Actions, which will perform some tasks for you when certain criteria are met. If you haven't worked with continuous integration and deployment (CI/CD) before, then this may seem like magic - but don't worry we will run through the commands.
411
411
412
412
The build.yml file contains several things, let's have a quick overview:
413
413
@@ -433,9 +433,9 @@ The action that it performs is what is under `jobs:build:steps`. There is a step
433
433
It sets the version of the package to be what we've set in the release tag based on a previous step.
434
434
{% endhint %}
435
435
436
-
Below this there is another step to push the package to Our, which again is like our approach locally - except now we add the API key as a Github secret so it's not public to everyone.
436
+
Below this there is another step to push the package to Our, which again is like our approach locally - except now we add the API key as a GitHub secret so it's not public to everyone.
437
437
438
-

438
+

439
439
440
440
```yml
441
441
- name: Push to Our
@@ -444,7 +444,7 @@ Below this there is another step to push the package to Our, which again is like
444
444
445
445
With these 2 commands and a few previous ones setting up the prerequisite build and nuget tools it is now ready to be fully automated.
446
446
447
-
Ensure you have set a Github secret with the name `UMBRACO_DEPLOY_KEY` and the value of the key from Our, and then go to your local solution and uncomment the UmbPack push command in the \~/.github/workflows/build.yml file.
447
+
Ensure you have set a GitHub secret with the name `UMBRACO_DEPLOY_KEY` and the value of the key from Our, and then go to your local solution and uncomment the UmbPack push command in the \~/.github/workflows/build.yml file.
Your solution and Github repo are now in sync, and the umbpack commands in the Github action are enabled and ready to run. Final step is to create a release tag and push it to Github:
457
+
Your solution and GitHub repo are now in sync, and the umbpack commands in the GitHub action are enabled and ready to run. Final step is to create a release tag and push it to GitHub:
458
458
459
459
```none
460
460
git tag release/1.0.0
461
461
git push origin release/1.0.0
462
462
```
463
463
464
-
At this point you can go to Github and visit the Action tab to see your Github action run. When it's completed successfully you can go to your package overview on Our and see the package there.
464
+
At this point you can go to GitHub and visit the Action tab to see your GitHub action run. When it's completed successfully you can go to your package overview on Our and see the package there.
Copy file name to clipboardExpand all lines: 10/umbraco-commerce/upgrading/version-specific-upgrades.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,4 +20,4 @@ See the [Migrate from Vendr to Umbraco Commerce guide](../upgrading/migrate-from
20
20
21
21
## Legacy version specific upgrade notes
22
22
23
-
You can find the version specific upgrade notes for versions out of support in the [Legacy documentation on Github](https://github.com/umbraco/UmbracoDocs/tree/umbraco-eol-versions). 
23
+
You can find the version specific upgrade notes for versions out of support in the [Legacy documentation on GitHub](https://github.com/umbraco/UmbracoDocs/tree/umbraco-eol-versions). 
0 commit comments