Giter Club home page Giter Club logo

md-website's Introduction

MonoDevelop Website build

This repository contains the files used for generating the MonoDevelop website.

Architecture

The site is made with Jekyll, an open source static site generator. GitHub Pages, where the site is hosted, natively supports Jekyll so every time someone pushes to this repository, the website will be built and updated.

For hosting it yourself, see Setting up a local copy of the website.

Contributing to the website

Note: Major issues or feature requests should be filed on the issue tracker first, so we can discuss the implications.

If you want to edit a page, the easiest way is to click the Edit page on GitHub link under the page title on the website.

This will open the source file on GitHub where you can click the pencil button to start editing: Arrow to pencil

GitHub's editor shows you both the Markdown source as well as a preview of the rendered page: Code editor

After you've finished your changes, enter a proper summary and description and click the "Propose file change" button to open a pull request: Propose file change

Setting up a local copy of the website

For larger changes, using the web-based editor on GitHub is not really convenient. A better way is to setup a local copy of the website where you can experiment.

Dependencies

  • Ruby - Jekyll is written in Ruby
  • Bundler - a package manager for Ruby. Install it by running gem install bundler

After you've forked and cloned the repository, run the following commands:

  1. bundle install - downloads the required libraries
  2. bundle exec jekyll serve - builds the website and runs a local webserver on port 4000

Note: you can add the --watch option when running jekyll serve to let Jekyll watch for file changes, which means the site will be rebuilt when a file is modified.

Note 2: on case-insensitive file systems like on Windows and macOS you'll run into redirect loops for some URLs. The workaround is to disable redirects locally by removing the gems: jekyll-redirect-from entry from _config.yml.

The site should now be running locally:

MD website

Repository structure

  • _includes - special folder contains snippets that can be included via {% include file.html %} in other pages
  • _layouts - special folder contains the layouts that are shared between pages. Layouts can be inherited, the root layout is base.html.
  • _site - the output of the generated site is stored here by default, this folder only exists after Jekyll built the site
  • archived - content that is no longer relevant but kept to keep external links working
  • css - contains the main stylesheet
  • developers - contains the source pages for the /developers website section
  • documentation - contains the source pages for the /documentation website section
  • download - contains the source pages for the /download website section
  • help - contains the source pages for the /help website section
  • images - stores the images used in pages
  • screenshots - contains the source pages for the /screenshots website section

md-website's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

md-website's Issues

Proposal: Add instructions for installing MonoDevelop on WSL

The instructions for installing MonoDevelop on Ubuntu 18.04, specifically importing the key to the apt server, requires dirmngr which I think has a dbus dependency and is not compatible with all instances of Ubuntu 18.04, including Ubuntu 18.04 on WSL.

See this bug at WSL.

See this workaround script I created for installing on WSL bypassing dirmngr.

Some users might want to install MonoDevelop on WSL.

I propose:

  1. List installing MonoDevelop on WSL using existing binaries as an option on the Windows installation instructions page, in addition to building from source.
  2. Either list the tweaked instructions for importing apt keys as listed in my workaround script in instructions for 1 above or point users to Linux instructions once they've gotten WSL installed and adjust the Ubuntu 18.04 key import instructions to be more friendly with WSL.

Also, FYI, MonoDevelop does not build on

Potentially outdated "Development - Getting Started" docs

It appears that the Development - Getting Started article may need to be updated to omit the --profile portion of the configure command. It may just be that line that needs to be updated, if that is sufficient for a clean Mac install. Alternatively, it could potentially point to OS-specific sections of the dedicated Building MonoDevelop page.

Background (should it help)

I decided to do a source-build of MonoDevelop on my OS X machine and got started by clicking the "Dev" link on the homepage, ending up on Development - Getting Started. From there, it suggested I run ./configure --profile=core (skipping the offer to run a Bitly link through Ruby for an OS X install). When that command ran, it failed with an error.

Error: automake failed.

Have you followed http://monodevelop.com/Developers/Mac_Support/Building_MonoDevelop_on_OS_X ?

FWIW, in the console output, the only error I could find prior to that seemed non-critical.

Makefile.am: error: required file './ChangeLog' not found

After following the dependency steps from the Mac OSX section of Building MonoDevelop, but not before the make steps, I tried the original ./configure --profile=core command again. It still failed with the same error message and URL recommendation.

Just for fun, I ignored the error and ran the Mac-specific make steps anyway. It built and ran successfully.

./configure --profile=mac
make
make run

[monodevelop.com] HTTPS needs to be used for screencast videos

Hello, I suggest using HTTPS protocol for embedding YouTube videos on documentation pages.

Mixed Content: The page at 'https://www.monodevelop.com/documentation/creating-custom-widgets-with-monodevelop/' was loaded over HTTPS, but requested an insecure resource 'http://www.youtube.com/embed/YymHsaZu8rM'. This request has been blocked; the content must be served over HTTPS.

Creating ASP.NET Projects outdated.

I am very new to programming, and was going through the Creating ASP.NET Projects tutorial. The steps in 'Creating the Solution' on that page no longer seem to apply. 'Adding some CodeBehind' resulted in a CS0103 error for outputlabel.Text in Default.aspx.cs which appears to have been fixed by editing Default.aspx.designer.cs. I would like to work on this, but thought I should start here as I am inexperienced and may be seeing problems where there are none or misunderstanding them.

Markdown tables are not rendering

Probably the format for tables in MD requires column descriptions. Tables used in API Overview don't have such data and they won't render.

Also, the html formatting is rendered as plain text if you make it work as a table.

Outdated "Creating A Simple Solution" tutorial

URL: https://www.monodevelop.com/documentation/creating-a-simple-solution/

It appears that MonoDevelop's menus have changed and this introduction tutorial has become difficult to follow for new users as a result. I went through it on Linux (pop_OS, similar to ubuntu) and ran into a number of problems.

  • Step 1 - C# cannot be selected first.
  • Step 2 - same problem as above. It also might be difficult to understand what is meant by "the Solution icon in the Solution Pad". Consider adding "Pad" or "Solution Pad" to the Terminology section. Consider adding methods for re-opening the Solution Pad in case it was closed (View>Pads>Solution)
  • Step 3 - could not find Common on this menu at all, much less "Startup Properties". Is this setting still in there?

Xamarin Studio. Cound not launch web server.

I'm trying to remote debugging. But I can't...

Steps (using Windows):

  1. I set an environment variable named MONODEVELOP_SDB_TEST to 1.
  2. Open project.
  3. Run -> Run With -> Custom Command Mono Soft Debugger.
  4. Write IP, Port.
  5. Click 'Listen' (or 'Connect', have the same problem).

After that I have a message:
"Could not launch web server. Unable to cast object of type 'MonoDevelop.AspNet.Execution.AspNetExecutionCommand' to type 'MonoDevelop.Core.Execution.DotNetExecutionCommand' ".

Task List bullet points intersect edge of table

This issue points out a quite minor issue with the page styling for task lists. The bullet points appear to intersect the edge of the list rather than appear within the list. This would be quite a simple fix that I would be happy to make a PR for if it is something that should be fixed.

This can be seen on a number of pages, including the ToDo page.


  • Example:
    image

Visual studio alternative?

I came here to get a visual studio alternative and what I did found?
Install visual studio to compile monodevelop (lowercase on purpose)

Well... that's....

What can I say

hope in the future I will find an IDE with GUI builder, codewritter compiler and debugger etc,,,, a bit more user friendly: just install and play with.. I would like to write create some thing, just compile and make it work just out of the box
I have even tried CodeBlocks too but it needs a lot of preparation to use it with wxwidgets... Just it doesn't work right after setup,

Maybe I am born in the wrong planet because this seems to be the planet Microsoft not planet Earth
But it seems that is not that day!
Hope in the future will change way of doing things.

quick-code-generation is not working on Visual Studio for Mac 2019

I am trying to develop an extension where you show a popup with some text fields. Depending on the input , the extension will generate some code or write some directories/files.

I got the last part working but i am not able to show a popup or dialog screen. The example below suggest clicking Alt + Insert which is equivalent to fn + return + option keys.

I am not getting any response in Visual Studio IDE.
My question is how to activate this popup feature in Visual Studio for Mac and is it possible to implement my scenario?

https://www.monodevelop.com/documentation/feature-list/quick-code-generation/

Attribute Questions

How can we use the attributes [DataInclude] and [DataItem] for namespace MonoDevelop.Core.Serialization? And what's the difference between them?

Update Develop Documentation for Visual Studio For Mac 2019?

after updating my visual studio to latest version 2019. I noticed that the DateInserter project i created is not working in the new 2019 IDE.

I noticed that some Classes are obsolete such as doc.Editor . I am not sure if it's the responsible for this issue.

I am getting the following when building but it completes the build:

WARNING [2019-04-04 15:24:26Z]: Stale account, cannot get vsid Error: did not find one of the files in sources//Library/Frameworks/Mono.framework/External/monodoc/MonoTouch-man

INFO [2019-04-04 15:24:24Z]: Fetching auth token for [[email protected]]. ERROR [2019-04-04 15:24:24Z]: Account was stale and reauthentication was silent, cannot get a token at this time.

Circular package reference in MonoDevelop

Hello:

I have been trying to install MonoDevelop on Kali (AKA Debian Buster) Linux. It appears to have broken the Synaptic Package Manager. No matter what I do, I can't seem to resolve the follow error:

E: /var/cache/apt/archives/libmono-corlib4.5-cil_6.12.0.122-0xamarin1+debian10b1_all.deb: trying to overwrite '/usr/lib/mono/4.5/mscorlib.dll', which is also in package libmono-corlib4.5-dll 6.8.0.105+dfsg-3.2

If someone could send me a workaround or a way to fix this I would appreciate it as I can't install any other software as long as these broken packages remain. As I am a relative newbie to Linux, a list of the explicit CLI commands would be helpful.

Thanks!

Python support feature?

The feature list currently shows python support as being a feature. However it appears that python support has been removed some time ago.

Perhaps this entry should be removed given the project does not seem to have python support any more.

Could you please provide a WinForms designer in MonoDevelop?

Could you please provide a WinForms designer in MonoDevelop?

Now, MonoDevelop does not have a WinForms designer, and WinForms files can only be edited manually (that is, by code).

According to the web page "https://www.mono-project.com/archived/winforms_designer/", there is an unfinished WinForms designer. It seems that this designer is close to being finished.

That web page says "The main stumble point is the lack of true Control transparency (WS_EX_TRANSPARENT), which is not yet supported by the MWF X11 backend, but is required for a proper Drag and Drop and other interaction (snap lines, etc) on the design service." But it seems that, this is not a big problem. Maybe things can be simplified. For example, when doing Drag and Drop, the designer may simply show a "placeholder" image instead of showing the actual control. For snap lines, maybe the designer can draw them manually, or simply do not show them. The Form designer of Visual Basic 6.0 does not have snap lines at all, but it is still very useful.

Besides this, it may need some efforts to put this designer into MonoDevelop. Now it seems that this designer is standalone.

Screenshot page

Add a selector at the top with Linux/Mac/Windows to see how it would look on all the platforms?

The "ResolvePackageAssets" task failed unexpectedly.

I tried using monodevelop for dotnet-core development. I'm using the lates dotnet-core runtime and the lates dotnet-core. The solution builds succesfully with dotnet build and runs with dotnet run without issues.
However attempting to build within monodevelop I get this error:

/opt/dotnet/sdk/3.0.100-preview3-010431/Sdks/Microsoft.NET.Sdk/targets/Microsoft.PackageDependencyResolution.targets(5,5): Error MSB4018: The "ResolvePackageAssets" task failed unexpectedly.
System.TypeLoadException: Could not resolve type with token 0100003f from typeref (expected class 'NuGet.Packaging.Core.PackageDependency' in assembly 'NuGet.Packaging, Version=5.0.0.4, Culture=neutral, PublicKeyToken=31bf3856ad364e35')
  at Microsoft.NET.Build.Tasks.ResolvePackageAssets+CacheWriter.GetPlatformPackageExclusions () [0x000d7] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.NET.Build.Tasks.ResolvePackageAssets+CacheWriter..ctor (Microsoft.NET.Build.Tasks.ResolvePackageAssets task, System.IO.Stream stream) [0x0009b] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.NET.Build.Tasks.ResolvePackageAssets+CacheReader.CreateReaderFromDisk (Microsoft.NET.Build.Tasks.ResolvePackageAssets task, System.Byte[] settingsHash) [0x0003a] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.NET.Build.Tasks.ResolvePackageAssets+CacheReader..ctor (Microsoft.NET.Build.Tasks.ResolvePackageAssets task) [0x00015] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.NET.Build.Tasks.ResolvePackageAssets.ReadItemGroups () [0x00000] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.NET.Build.Tasks.ResolvePackageAssets.ExecuteCore () [0x00018] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.NET.Build.Tasks.TaskBase.Execute () [0x00000] in <9524e6fbf1724027a475d15b01fab866>:0 
  at Microsoft.Build.BackEnd.TaskExecutionHost.Microsoft.Build.BackEnd.ITaskExecutionHost.Execute () [0x00029] in <58f0218f988743a48dd7c84cbe933f4e>:0 
  at Microsoft.Build.BackEnd.TaskBuilder.ExecuteInstantiatedTask (Microsoft.Build.BackEnd.ITaskExecutionHost taskExecutionHost, Microsoft.Build.BackEnd.Logging.TaskLoggingContext taskLoggingContext, Microsoft.Build.BackEnd.TaskHost taskHost, Microsoft.Build.BackEnd.ItemBucket bucket, Microsoft.Build.BackEnd.TaskExecutionMode howToExecuteTask) [0x001f6] in <58f0218f988743a48dd7c84cbe933f4e>:0  (MSB4018) (Msf.Common)

Here's the output of dotnet --info:

dotnet --info
.NET Core SDK (reflecting any global.json):
 Version:   3.0.100-preview3-010431
 Commit:    d72abce213

Runtime Environment:
 OS Name:     arch
 OS Version:  
 OS Platform: Linux
 RID:         linux-x64
 Base Path:   /opt/dotnet/sdk/3.0.100-preview3-010431/

Host (useful for support):
  Version: 3.0.0-preview3-27503-5
  Commit:  3844df9537

.NET Core SDKs installed:
  2.2.105 [/opt/dotnet/sdk]
  3.0.100-preview3-010431 [/opt/dotnet/sdk]

.NET Core runtimes installed:
  Microsoft.AspNetCore.App 3.0.0-preview3-19153-02 [/opt/dotnet/shared/Microsoft.AspNetCore.App]
  Microsoft.NETCore.App 3.0.0-preview3-27503-5 [/opt/dotnet/shared/Microsoft.NETCore.App]

To install additional .NET Core runtimes or SDKs:
  https://aka.ms/dotnet-download

Attaching pic of the (I assume) relevant settings in monodevelop:

image

image

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.