Skip to content

Commit

Permalink
minor
Browse files Browse the repository at this point in the history
  • Loading branch information
iJungleboy committed Nov 9, 2023
1 parent 613df51 commit 2ec214a
Show file tree
Hide file tree
Showing 20 changed files with 542 additions and 87 deletions.
24 changes: 24 additions & 0 deletions 2sxc Docs Generator/pages/guides/vscode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ VSCode is amazing right out of the box, but to really be productive, you need to
1. Configure each App with
1. Intellisense (see below)
1. Ignore the `obj` and `.vs` folders (see below)
1. Check possible edge cases (see below)

With these preparations, VS-Code is able to assist in basic C# code.
It can't provide IntelliSense for 2sxc specific APIs yet, so for that, read on.
Expand Down Expand Up @@ -86,6 +87,29 @@ Add these lines to your `.gitignore` file to prevent temporary files from being
obj/
```

## Check for Edge Cases - DNN with .net 4.7.2 / 4.8

If you're using DNN with .net 4.7.2 or 4.8, you may have to do some extra work.
We're still not 100% sure what this is, since our dev PCs are always setup with all kinds of build tools where it works.
According to research by [Accuraty](https://www.accu4.com/H2R2S/VS-Code-IntelliSense)
you may need to follow the instructions as noted on the [C# extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp).

The **C#** extension is auto-installed by the Dev-Kit, but there is this (quoted):

> [!NOTE]
> Note: If working on a solution that requires versions prior to .NET 6 or non-solution based projects, install a .NET Framework runtime and MSBuild tooling.
>
> * Set omnisharp.useModernNet to false and set dotnet.server.useOmnisharp to true
> * Uninstall or disable C# Dev Kit **we're not sure if this is correct any more!**
> * Windows: .NET Framework along with MSBuild Tools
> * MacOS/Linux: Mono with MSBuild
According to our current understanding you don't need to do this is you have Visual Studio 2022 installed.
We assume that already includes all the bits which VS Code needs as well.

We haven't been able to verify or simplify this, but if you're having trouble,
do read the blog post by [Accuraty](https://www.accu4.com/H2R2S/VS-Code-IntelliSense) as well.


## Configure an App for JavaScript IntelliSense

Expand Down
2 changes: 1 addition & 1 deletion docs/api/dot-net/ToSic.Eav.Apps.App.html
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ <h5>Inherited Members</h5>
<a class="xref" href="ToSic.Eav.Apps.AppBase-1.html#ToSic_Eav_Apps_AppBase_1_AppId">AppBase&lt;App.MyServices&gt;.AppId</a>
</div>
<div>
<a class="xref" href="ToSic.Eav.Apps.AppBase-1.html#ToSic_Eav_Apps_AppBase_1_Init_ToSic_Eav_Apps_IAppIdentity_">AppBase&lt;App.MyServices&gt;.Init(IAppIdentity)</a>
<a class="xref" href="ToSic.Eav.Apps.AppBase-1.html#ToSic_Eav_Apps_AppBase_1_InitAppBaseIds_ToSic_Eav_Apps_IAppIdentity_">AppBase&lt;App.MyServices&gt;.InitAppBaseIds(IAppIdentity)</a>
</div>
</div>
<h6><strong>Namespace</strong>: <a class="xref" href="ToSic.html">ToSic</a>.<a class="xref" href="ToSic.Eav.html">Eav</a>.<a class="xref" href="ToSic.Eav.Apps.html">Apps</a></h6>
Expand Down
8 changes: 4 additions & 4 deletions docs/api/dot-net/ToSic.Eav.Apps.AppBase-1.html
Original file line number Diff line number Diff line change
Expand Up @@ -310,19 +310,19 @@ <h3 id="methods">Methods
</h3>
<span class="small pull-right mobile-hide">
<span class="divider">|</span>
<a href="https://github.com/2sic/eav-server/new/develop/apiSpec/new?filename=ToSic_Eav_Apps_AppBase_1_Init_ToSic_Eav_Apps_IAppIdentity_.md&amp;value=---%0Auid%3A%20ToSic.Eav.Apps.AppBase%601.Init(ToSic.Eav.Apps.IAppIdentity)%0Asummary%3A%20&#39;*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax&#39;%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A">Improve this Doc</a>
<a href="https://github.com/2sic/eav-server/new/develop/apiSpec/new?filename=ToSic_Eav_Apps_AppBase_1_InitAppBaseIds_ToSic_Eav_Apps_IAppIdentity_.md&amp;value=---%0Auid%3A%20ToSic.Eav.Apps.AppBase%601.InitAppBaseIds(ToSic.Eav.Apps.IAppIdentity)%0Asummary%3A%20&#39;*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax&#39;%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A">Improve this Doc</a>
</span>
<span class="small pull-right mobile-hide">
<a href="https://github.com/2sic/eav-server/blob/develop/ToSic.Eav.Core/Apps/AppBase.cs/#L29">View Source</a>
</span>
<a id="ToSic_Eav_Apps_AppBase_1_Init_" data-uid="ToSic.Eav.Apps.AppBase`1.Init*"></a>
<h4 id="ToSic_Eav_Apps_AppBase_1_Init_ToSic_Eav_Apps_IAppIdentity_" data-uid="ToSic.Eav.Apps.AppBase`1.Init(ToSic.Eav.Apps.IAppIdentity)">Init(IAppIdentity)</h4>
<a id="ToSic_Eav_Apps_AppBase_1_InitAppBaseIds_" data-uid="ToSic.Eav.Apps.AppBase`1.InitAppBaseIds*"></a>
<h4 id="ToSic_Eav_Apps_AppBase_1_InitAppBaseIds_ToSic_Eav_Apps_IAppIdentity_" data-uid="ToSic.Eav.Apps.AppBase`1.InitAppBaseIds(ToSic.Eav.Apps.IAppIdentity)">InitAppBaseIds(IAppIdentity)</h4>
<div class="markdown level1 summary"><p>App identity containing zone/app combination</p>
</div>
<div class="markdown level1 conceptual"></div>
<h5 class="declaration">Declaration</h5>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">protected AppBase&lt;TServices&gt; Init(IAppIdentity app)</code></pre>
<pre><code class="lang-csharp hljs">protected AppBase&lt;TServices&gt; InitAppBaseIds(IAppIdentity app)</code></pre>
</div>
<h5 class="parameters">Parameters</h5>
<table class="table table-bordered table-condensed">
Expand Down
2 changes: 1 addition & 1 deletion docs/api/dot-net/ToSic.Eav.Apps.AppState.html
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ <h5>Inherited Members</h5>
<a class="xref" href="ToSic.Eav.Apps.AppBase-1.html#ToSic_Eav_Apps_AppBase_1_AppId">AppBase&lt;MyServicesEmpty&gt;.AppId</a>
</div>
<div>
<a class="xref" href="ToSic.Eav.Apps.AppBase-1.html#ToSic_Eav_Apps_AppBase_1_Init_ToSic_Eav_Apps_IAppIdentity_">AppBase&lt;MyServicesEmpty&gt;.Init(IAppIdentity)</a>
<a class="xref" href="ToSic.Eav.Apps.AppBase-1.html#ToSic_Eav_Apps_AppBase_1_InitAppBaseIds_ToSic_Eav_Apps_IAppIdentity_">AppBase&lt;MyServicesEmpty&gt;.InitAppBaseIds(IAppIdentity)</a>
</div>
</div>
<h6><strong>Namespace</strong>: <a class="xref" href="ToSic.html">ToSic</a>.<a class="xref" href="ToSic.Eav.html">Eav</a>.<a class="xref" href="ToSic.Eav.Apps.html">Apps</a></h6>
Expand Down
2 changes: 1 addition & 1 deletion docs/api/dot-net/ToSic.Eav.DataSources.Sys.Features.html
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ <h3 id="implements">Implements</h3>
<a href="https://github.com/2sic/eav-server/new/develop/apiSpec/new?filename=ToSic_Eav_DataSources_Sys_Features.md&amp;value=---%0Auid%3A%20ToSic.Eav.DataSources.Sys.Features%0Asummary%3A%20&#39;*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax&#39;%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A" class="contribution-link">Improve this Doc</a>
</li>
<li>
<a href="https://github.com/2sic/eav-server/blob/develop/ToSic.Eav.Apps/DataSources/System/Features.cs/#L18" class="contribution-link">View Source</a>
<a href="https://github.com/2sic/eav-server/blob/develop/ToSic.Eav.Apps/DataSources/System/Features.cs/#L15" class="contribution-link">View Source</a>
</li>
</ul>
</div>
Expand Down
Loading

0 comments on commit 2ec214a

Please sign in to comment.