-
Notifications
You must be signed in to change notification settings - Fork 2.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from umbraco/dev-v7
Latest master
- Loading branch information
Showing
3,842 changed files
with
126,368 additions
and
123,783 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| # editorconfig.org | ||
|
|
||
| # top-most EditorConfig file | ||
| root = true | ||
|
|
||
| # Default settings: | ||
| # A newline ending every file | ||
| # Use 4 spaces as indentation | ||
| [*] | ||
| insert_final_newline = true | ||
| indent_style = space | ||
| indent_size = 4 | ||
|
|
||
| # Trim trailing whitespace, limited support. | ||
| # https://github.com/editorconfig/editorconfig/wiki/Property-research:-Trim-trailing-spaces | ||
| trim_trailing_whitespace = true |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,49 @@ | ||
| *.doc diff=astextplain | ||
| *.DOC diff=astextplain | ||
| *.docx diff=astextplain | ||
| *.DOCX diff=astextplain | ||
| *.dot diff=astextplain | ||
| *.DOT diff=astextplain | ||
| *.pdf diff=astextplain | ||
| *.PDF diff=astextplain | ||
| *.rtf diff=astextplain | ||
| *.RTF diff=astextplain | ||
|
|
||
| *.jpg binary | ||
| *.png binary | ||
| *.gif binary | ||
|
|
||
| *.cs text=auto diff=csharp | ||
| *.vb text=auto | ||
| *.c text=auto | ||
| *.cpp text=auto | ||
| *.cxx text=auto | ||
| *.h text=auto | ||
| *.hxx text=auto | ||
| *.py text=auto | ||
| *.rb text=auto | ||
| *.java text=auto | ||
| *.html text=auto | ||
| *.htm text=auto | ||
| *.css text=auto | ||
| *.scss text=auto | ||
| *.sass text=auto | ||
| *.less text=auto | ||
| *.js text=auto | ||
| *.lisp text=auto | ||
| *.clj text=auto | ||
| *.sql text=auto | ||
| *.php text=auto | ||
| *.lua text=auto | ||
| *.m text=auto | ||
| *.asm text=auto | ||
| *.erl text=auto | ||
| *.fs text=auto | ||
| *.fsx text=auto | ||
| *.hs text=auto | ||
|
|
||
| *.csproj text=auto merge=union | ||
| *.vbproj text=auto merge=union | ||
| *.fsproj text=auto merge=union | ||
| *.dbproj text=auto merge=union | ||
| *.sln text=auto eol=crlf merge=union |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,186 @@ | ||
| Umbraco Cms Build | ||
| -- | ||
| ---- | ||
|
|
||
| # Quick! | ||
|
|
||
| To build Umbraco, fire PowerShell and move to Umbraco's repository root (the directory that contains `src`, `build`, `README.md`...). There, trigger the build with the following command: | ||
|
|
||
| build\build.ps1 | ||
|
|
||
| By default, this builds the current version. It is possible to specify a different version as a parameter to the build script: | ||
|
|
||
| build\build.ps1 7.6.44 | ||
|
|
||
| Valid version strings are defined in the `Set-UmbracoVersion` documentation below. | ||
|
|
||
| ## PowerShell Quirks | ||
|
|
||
| There is a good chance that running `build.ps1` ends up in error, with messages such as | ||
|
|
||
| >The file ...\build\build.ps1 is not digitally signed. You cannot run this script on the current system. For more information about running scripts and setting execution policy, see about_Execution_Policies. | ||
| PowerShell has *Execution Policies* that may prevent the script from running. You can check the current policies with: | ||
|
|
||
| PS> Get-ExecutionPolicy -List | ||
|
|
||
| Scope ExecutionPolicy | ||
| ----- --------------- | ||
| MachinePolicy Undefined | ||
| UserPolicy Undefined | ||
| Process Undefined | ||
| CurrentUser Undefined | ||
| LocalMachine RemoteSigned | ||
|
|
||
| Policies can be `Restricted`, `AllSigned`, `RemoteSigned`, `Unrestricted` and `Bypass`. Scopes can be `MachinePolicy`, `UserPolicy`, `Process`, `CurrentUser`, `LocalMachine`. You need the current policy to be `RemoteSigned`—as long as it is `Undefined`, the script cannot run. You can change the current user policy with: | ||
|
|
||
| PS> Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned | ||
|
|
||
| Alternatively, you can do it at machine level, from within an elevated PowerShell session: | ||
|
|
||
| PS> Set-ExecutionPolicy -Scope LocalMachine -ExecutionPolicy RemoteSigned | ||
|
|
||
| And *then* the script should run. It *might* however still complain about executing scripts, with messages such as: | ||
|
|
||
| >Security warning - Run only scripts that you trust. While scripts from the internet can be useful, this script can potentially harm your computer. If you trust this script, use the Unblock-File cmdlet to allow the script to run without this warning message. Do you want to run ...\build\build.ps1? | ||
| [D] Do not run [R] Run once [S] Suspend [?] Help (default is "D"): | ||
|
|
||
| This is usually caused by the scripts being *blocked*. And that usually happens when the source code has been downloaded as a Zip file. When Windows downloads Zip files, they are marked as *blocked* (technically, they have a Zone.Identifier alternate data stream, with a value of "3" to indicate that they were downloaded from the Internet). And when such a Zip file is un-zipped, each and every single file is also marked as blocked. | ||
|
|
||
| The best solution is to unblock the Zip file before un-zipping: right-click the files, open *Properties*, and there should be a *Unblock* checkbox at the bottom of the dialog. If, however, the Zip file has already been un-zipped, it is possible to recursively unblock all files from PowerShell with: | ||
|
|
||
| PS> Get-ChildItem -Recurse *.* | Unblock-File | ||
|
|
||
| ## Notes | ||
|
|
||
| Git might have issues dealing with long file paths during build. You may want/need to enable `core.longpaths` support (see [this page](https://github.com/msysgit/msysgit/wiki/Git-cannot-create-a-file-or-directory-with-a-long-path) for details). | ||
|
|
||
| # Build | ||
|
|
||
| The Umbraco Build solution relies on a PowerShell module. The module needs to be imported into PowerShell. From within Umbraco's repository root: | ||
|
|
||
| build\build.ps1 -ModuleOnly | ||
|
|
||
| Or the abbreviated form: | ||
|
|
||
| build\build.ps1 -mo | ||
|
|
||
| Once the module has been imported, a set of commands are added to PowerShell. | ||
|
|
||
| ## Get-UmbracoBuildEnv | ||
|
|
||
| Gets the Umbraco build environment ie NuGet, Semver, Visual Studio, etc. Downloads things that can be downloaded such as NuGet. Examples: | ||
|
|
||
| $uenv = Get-UmbracoBuildEnv | ||
| Write-Host $uenv.SolutionRoot | ||
| &$uenv.NuGet help | ||
|
|
||
| The object exposes the following properties: | ||
|
|
||
| * `SolutionRoot`: the absolute path to the solution root | ||
| * `VisualStudio`: a Visual Studio object (see below) | ||
| * `NuGet`: the absolute path to the NuGet executable | ||
| * `Zip`: the absolute path to the 7Zip executable | ||
| * `VsWhere`: the absolute path to the VsWhere executable | ||
| * `NodePath`: the absolute path to the Node install | ||
| * `NpmPath`: the absolute path to the Npm install | ||
|
|
||
| The Visual Studio object is `null` when Visual Studio has not been detected (eg on VSTS). When not null, the object exposes the following properties: | ||
|
|
||
| * `Path`: Visual Studio installation path (eg some place under `Program Files`) | ||
| * `Major`: Visual Studio major version (eg `15` for VS 2017) | ||
| * `Minor`: Visual Studio minor version | ||
| * `MsBUild`: the absolute path to the MsBuild executable | ||
|
|
||
| ## Get-UmbracoVersion | ||
|
|
||
| Gets an object representing the current Umbraco version. Example: | ||
|
|
||
| $v = Get-UmbracoVersion | ||
| Write-Host $v.Semver | ||
|
|
||
| The object exposes the following properties: | ||
|
|
||
| * `Semver`: the semver object representing the version | ||
| * `Release`: the main part of the version (eg `7.6.33`) | ||
| * `Comment`: the pre release part of the version (eg `alpha02`) | ||
| * `Build`: the build number part of the version (eg `1234`) | ||
|
|
||
| ## Set-UmbracoVersion | ||
|
|
||
| Modifies Umbraco files with the new version. | ||
|
|
||
| >This entirely replaces the legacy `UmbracoVersion.txt` file. | ||
| The version must be a valid semver version. It can include a *pre release* part (eg `alpha02`) and/or a *build number* (eg `1234`). Examples: | ||
|
|
||
| Set-UmbracoVersion 7.6.33 | ||
| Set-UmbracoVersion 7.6.33-alpha02 | ||
| Set-UmbracoVersion 7.6.33+1234 | ||
| Set-UmbracoVersion 7.6.33-beta05+5678 | ||
|
|
||
| Note that `Set-UmbracoVersion` enforces a slightly more restrictive naming scheme than what semver would tolerate. The pre release part can only be composed of a-z and 0-9, therefore `alpha033` is considered valid but not `alpha.033` nor `alpha033-preview` nor `RC2` (would need to be lowercased `rc2`). | ||
|
|
||
| >It is considered best to add trailing zeroes to pre releases, else NuGet gets the order of versions wrong. So if you plan to have more than 10, but no more that 100 alpha versions, number the versions `alpha00`, `alpha01`, etc. | ||
| ## Build-Umbraco | ||
|
|
||
| Builds Umbraco. Temporary files are generated in `build.tmp` while the actual artifacts (zip files, NuGet packages...) are produced in `build.out`. Example: | ||
|
|
||
| Build-Umbraco | ||
|
|
||
| Some log files, such as MsBuild logs, are produced in `build.tmp` too. The `build` directory should remain clean during a build. | ||
|
|
||
| ### web.config | ||
|
|
||
| Building Umbraco requires a clean `web.config` file in the `Umbraco.Web.UI` project. If a `web.config` file already exists, the `pre-build` task (see below) will save it as `web.config.temp-build` and replace it with a clean copy of `web.Template.config`. The original file is replaced once it is safe to do so, by the `pre-packages` task. | ||
|
|
||
| ## Build-UmbracoDocs | ||
|
|
||
| Builds umbraco documentation. Temporary files are generated in `build.tmp` while the actual artifacts (docs...) are produced in `build.out`. Example: | ||
|
|
||
| Build-UmbracoDocs | ||
|
|
||
| Some log files, such as MsBuild logs, are produced in `build.tmp` too. The `build` directory should remain clean during a build. | ||
|
|
||
| ## Verify-NuGet | ||
|
|
||
| Verifies that projects all require the same version of their dependencies, and that NuSpec files require versions that are consistent with projects. Example: | ||
|
|
||
| Verify-NuGet | ||
|
|
||
| # VSTS | ||
|
|
||
| Continuous integration, nightly builds and release builds run on VSTS. | ||
|
|
||
| VSTS uses the `Build-Umbraco` command several times, each time passing a different *target* parameter. The supported targets are: | ||
|
|
||
| * `pre-build`: prepares the build | ||
| * `compile-belle`: compiles Belle | ||
| * `compile-umbraco`: compiles Umbraco | ||
| * `pre-tests`: prepares the tests | ||
| * `compile-tests`: compiles the tests | ||
| * `pre-packages`: prepares the packages | ||
| * `pkg-zip`: creates the zip files | ||
| * `pre-nuget`: prepares NuGet packages | ||
| * `pkg-nuget`: creates NuGet packages | ||
|
|
||
| All these targets are executed when `Build-Umbraco` is invoked without a parameter (or with the `all` parameter). On VSTS, compilations (of Umbraco and tests) are performed by dedicated VSTS tasks. Similarly, creating the NuGet packages is also performed by dedicated VSTS tasks. | ||
|
|
||
| Finally, the produced artifacts are published in two containers that can be downloaded from VSTS: `zips` contains the zip files while `nuget` contains the NuGet packages. | ||
|
|
||
| >During a VSTS build, some environment `UMBRACO_*` variables are exported by the `pre-build` target and can be reused in other targets *and* in VSTS tasks. The `UMBRACO_TMP` environment variable is used in `Umbraco.Tests` to disable some tests that have issues with VSTS at the moment. | ||
| # Notes | ||
|
|
||
| *This part needs to be cleaned up* | ||
|
|
||
| Nightlies should use some sort of build number. | ||
|
|
||
| We should increment versions as soon as a version is released. Ie, as soon as `7.6.33` is released, we should `Set-UmbracoVersion 7.6.34-alpha` and push. | ||
|
|
||
| NuGet / NuSpec consistency checks are performed in tests. We should move it so it is done as part of the PowerShell script even before we try to compile and run the tests. | ||
|
|
||
| There are still a few commands in `build` (to build docs, install Git or cleanup the install) that will need to be migrated to PowerShell. | ||
|
|
||
| /eof |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,80 @@ | ||
| # Code of Conduct | ||
|
|
||
| ## 1. Purpose | ||
|
|
||
| A primary goal of Umbraco CMS is to be inclusive to the largest number of contributors, with the most varied and diverse backgrounds possible. As such, we are committed to providing a friendly, safe and welcoming environment for all, regardless of gender, sexual orientation, ability, ethnicity, socioeconomic status, and religion (or lack thereof). | ||
|
|
||
| This code of conduct outlines our expectations for all those who participate in our community, as well as the consequences for unacceptable behavior. | ||
|
|
||
| We invite all those who participate in Umbraco CMS to help us create safe and positive experiences for everyone. | ||
|
|
||
| ## 2. Open Source Citizenship | ||
|
|
||
| A supplemental goal of this Code of Conduct is to increase open source citizenship by encouraging participants to recognize and strengthen the relationships between our actions and their effects on our community. | ||
|
|
||
| Communities mirror the societies in which they exist and positive action is essential to counteract the many forms of inequality and abuses of power that exist in society. | ||
|
|
||
| If you see someone who is making an extra effort to ensure our community is welcoming, friendly, and encourages all participants to contribute to the fullest extent, we want to know. | ||
|
|
||
| ## 3. Expected Behavior | ||
|
|
||
| The following behaviors are expected and requested of all community members: | ||
|
|
||
| * Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community. | ||
| * Exercise consideration and respect in your speech and actions. | ||
| * Attempt collaboration before conflict. | ||
| * Refrain from demeaning, discriminatory, or harassing behavior and speech. | ||
| * Be mindful of your surroundings and of your fellow participants. Alert community leaders if you notice a dangerous situation, someone in distress, or violations of this Code of Conduct, even if they seem inconsequential. | ||
| * Remember that community event venues may be shared with members of the public; please be respectful to all patrons of these locations. | ||
|
|
||
| ## 4. Unacceptable Behavior | ||
|
|
||
| The following behaviors are considered harassment and are unacceptable within our community: | ||
|
|
||
| * Violence, threats of violence or violent language directed against another person. | ||
| * Sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory jokes and language. | ||
| * Posting or displaying sexually explicit or violent material. | ||
| * Posting or threatening to post other people’s personally identifying information ("doxing"). | ||
| * Personal insults, particularly those related to gender, sexual orientation, race, religion, or disability. | ||
| * Inappropriate photography or recording. | ||
| * Inappropriate physical contact. You should have someone’s consent before touching them. | ||
| * Unwelcome sexual attention. This includes, sexualized comments or jokes; inappropriate touching, groping, and unwelcomed sexual advances. | ||
| * Deliberate intimidation, stalking or following (online or in person). | ||
| * Advocating for, or encouraging, any of the above behavior. | ||
| * Sustained disruption of community events, including talks and presentations. | ||
|
|
||
| ## 5. Consequences of Unacceptable Behavior | ||
|
|
||
| Unacceptable behavior from any community member, including sponsors and those with decision-making authority, will not be tolerated. | ||
|
|
||
| Anyone asked to stop unacceptable behavior is expected to comply immediately. | ||
|
|
||
| If a community member engages in unacceptable behavior, the community organizers may take any action they deem appropriate, up to and including a temporary ban or permanent expulsion from the community without warning (and without refund in the case of a paid event). | ||
|
|
||
| ## 6. Reporting Guidelines | ||
|
|
||
| If you are subject to or witness unacceptable behavior, or have any other concerns, please notify a community organizer as soon as possible. Please contact Sebastiaan Janssen - [[email protected]](mailto:[email protected]). | ||
|
|
||
| Additionally, community organizers are available to help community members engage with local law enforcement or to otherwise help those experiencing unacceptable behavior feel safe. In the context of in-person events, organizers will also provide escorts as desired by the person experiencing distress. | ||
|
|
||
| ## 7. Addressing Grievances | ||
|
|
||
| If you feel you have been falsely or unfairly accused of violating this Code of Conduct, you should notify Umbraco with a concise description of your grievance. Your grievance will be handled in accordance with our existing governing policies. | ||
|
|
||
| ## 8. Scope | ||
|
|
||
| We expect all community participants (contributors, paid or otherwise; sponsors; and other guests) to abide by this Code of Conduct in all community venues–online and in-person–as well as in all one-on-one communications pertaining to community business. | ||
|
|
||
| This code of conduct and its related procedures also applies to unacceptable behavior occurring outside the scope of community activities when such behavior has the potential to adversely affect the safety and well-being of community members. | ||
|
|
||
| ## 9. Contact info | ||
|
|
||
| Sebastiaan Janssen - [[email protected]](mailto:[email protected]) | ||
|
|
||
| ## 10. License and attribution | ||
|
|
||
| This Code of Conduct is distributed under a [Creative Commons Attribution-ShareAlike license](http://creativecommons.org/licenses/by-sa/3.0/). | ||
|
|
||
| Portions of text derived from the [Django Code of Conduct](https://www.djangoproject.com/conduct/) and the [Geek Feminism Anti-Harassment Policy](http://geekfeminism.wikia.com/wiki/Conference_anti-harassment/Policy). | ||
|
|
||
| Retrieved on November 22, 2016 from [http://citizencodeofconduct.org/](http://citizencodeofconduct.org/) |
Oops, something went wrong.