Компілятор F#, базова бібліотека F#, та інструменти редагування Ф#

Ця гілка для роботи над локалізованою версією F#. Мета цього єксперіменту створити

• Створити локалізовану мову програмування
  • Пропонувати переклад ключових слів
  • Пропонувати переклад псевдо-ключових слів таких як async/None/Some/int/float
  • Зробити приклади базових мовних конструкцій
  • Створити локалізовану на українську мову базову бібліотеку
• Створити локалізовани інструменти редагування
  • Візуал Студія
    • Розробка
    • Упакування
  • Іонід
    • Розробка
    • Упакування
  • Райдер
    • Розробка
    • Упакування
  • .NET Polyglot Notebooks
    • Розробка
    • Упакування
• Перекласти декілька відомих проектів на українську
  • Мати можливість роботи с консолью
  • Мати можливість робити запроси до веб
  • Мати можливість роботи з файлами
  • Мати можливість роботи з базами даних
  • Мати можливість створення десктопних програм
  • Мати можливість створення веб-додатків

Лише частина роботи буде розміщена у цьому репозіторії, інші частини роботи будуть проводиться у форках відповідних проектів.

Ми запрошуємо вас зробити внесок у майбутні випуски Ф# компілятра, базової біблітеки, та інструментів. Розробка цього репозіторія може проводитися на будь якій ОС яка підтримує .NET.

Ви також повинні мати встановлений .NET 7 SDK звідси.

Нащо ций діалект

Коли я створював цей діалект моя мотивація була полегшити перші місяці(або роки) навчання програмуванню та процедурному мисленню. За свою кар'єру, я дуже часто бачив помилки коли люди плутали цілі використання тієї, чи іншої концепції у програмуванні. Я вважаю що це на сам перед тому що коли люди вчаться програмуванню, вони вчать англійску мову водночас, потім вони читають статі на англійскій, і використовують сленг. Як на мене це робить навчання не англомовним людям більш важким, і якщо людина із социально-вразливого шару суспільства, це додає що один бар'єр, яких як на мене і так забагато. Наприклад є Scratch, має безліч перекладів на інші мови, чому ми не можемо зробити так само із мовами програмування? Також я не можу відкинути аргументи що навчатися краще якійсь індустріальній мові. Саме тому (а також тому що це було відносно легко зробити) з'явився цей діалект F# де ви можете писати як на F# або цілком на українскій.

Внести вклад

Швидкий старт на Windows

Збудувати із командної строки:

build.cmd

The build depends on an installation of Visual Studio. To build the compiler without this dependency use:

build.cmd -noVisualStudio

Після того як збудова завершена, відкрийте або FSharp.sln або VisualFSharp.sln у редакторі на ваш смак. Остання рішення більше але воно включає Ф# інструменти для Visual Studio та супутню інфраструктуру.

Швидкий старт на Linux або macOS

Збудувати із командної строки:

./build.sh

Після того як збудова завершена, відкрийте FSharp.sln у редакторі на ваш смак.

Документація для співвкладників

• The Compiler Documentation is essential reading for any larger contributions to the F# compiler codebase and contains links to learning videos, architecture diagrams and other resources.

• The same docs are also published as the The F# Compiler Guide. It also contains the public searchable docs for FSharp.Compiler.Service component.

• See DEVGUIDE.md for more details on configurations for building the codebase. In practice, you only really need to run build.cmd/build.sh.

• See TESTGUIDE.md for information about the various test suites in this codebase and how to run them individually.

Докуметація для Ф# громади

• The F# Documentation is the primary documentation for F#. The source for the content is here.

• The F# Language Design Process is the fundamental design process for the language, from suggestions to completed RFCs. There are also tooling RFCs for some topics where cross-community co-operation and visibility is most useful.

• The F# Language Specification is an in-depth description of the F# language. This is essential for understanding some behaviors of the F# compiler and some of the rules within the compiler codebase. For example, the order and way name resolution happens is specified here, which greatly impacts how the code in Name Resolutions works and why certain decisions are made.

Змінені ключові слова

Нижче приведени приклади змінених ключових слів. Італіком відзначені слова, переклад яких є сумнівним.

F#	Ф#
abstract	абстрактний
and	та
as	як
assert	ствердити
asr	--
base	база
begin	початок
class	клас
const	конст
default	замовчання
delegate	делегат
do	зробити
done	зроблено
downcast	--
downto	--
elif	інякщо
else	інакше
end	кінець
exception	виключення
extern	зовнішній
false	ложь
finally	востаннє
fixed	фіксовано
for	для
fun	фун
function	функція
global	глобальний
if	якщо
in	у
inherit	успадкує
inline	інлайн
interface	інтерфейс
internal	внутрішній
land	--
lazy	ледачий
let	нехай
lor	--
lsl	--
lsr	--
lxor	--
match	відповідає
member	член
mod	мод
module	модуль
mutable	змінливий
namespace	простір
new	новий
null	нуль
of	з
open	відкрити
or	або
override	перевизначити
private	приватний
public	відкритий
rec	рек
return	повернути
sig	сіг
static	статичний
struct	структ
then	тоді
to	до
true	істина
try	спробувати
type	тип
upcast	--
use	вживати
val	знач
void	пусто
when	коли
while	доки
with	із
yield	поступатися

Приклади над якими треба розмірковувати як перекласти ключові слова.

type x with
	member this.test(name: string) = 
		match name with
			| "1" -> true
			| _ -> false

Тестові проєкти

• ВеселШарп Весела кросс-платформенна графична біблиотека, базуючаяся на библиотеці із Small Basic, зроблена спеціально для Ф# та C#.
• .NET Interactive ядро для Ф#
• Адаптатція FSharp.Core до української мови
• Інтерактивний сайт де можна спробувати мову Ф#. Сам інтерактивний репл можна побачити за адресою https://kant2002.github.io/fable-repl-ua/
• [Конфігурація для Binder] де можна погратися із Ф#. Запуск Binder

Ніякий вклад не замалий

Якщо ви знайдете навіть опечатку з одної літери, ми раді прийняти зміни! Навіть якщо кодова база може виглядати лячною для початківців, ми та інші співвкладники будемо раді допомогти вам і надалі.

Per-build NuGet packages

Per-build versions of our NuGet packages are available via this URL: https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-tools/nuget/v3/index.json

Branches

These are the branches in use:

• main

  • Almost all contributions go here.
  • Able to be built, installed and used in the latest public Visual Studio release.
  • May contain updated F# features and logic.
  • Used to build nightly VSIX (see above).

• release/dev15.9

  • Long-term servicing branch for VS 2017 update 15.9.x. We do not expect to service that release, but if we do, that's where the changes will go.

• release/dev17.x

  • Latest release branch for the particular point release of Visual Studio.
  • Incorporates features and fixes from main up to a particular branch point, then selective cherry-picks.
  • May contain new features that depend on new things or fixes in the corresponding forthcoming Visual Studio release.
  • Gets integrated back into main once the corresponding Visual Studio release is made.

F# language and core library evolution

Evolution of the F# language and core library follows a process spanning two additional repositories. The process is as follows:

1. Use the F# language suggestions repo to search for ideas, vote on ones you like, submit new ideas, and discuss details with the F# community.
2. Ideas that are "approved in principle" are eligible for a new RFC in the F# language design repo. This is where the technical specification and discussion of approved suggestions go.
3. Implementations and testing of an RFC are submitted to this repository.

License

This project is subject to the MIT License. A copy of this license is in License.txt.

Code of Conduct

This project has adopted the Contributor Covenant code of conduct to clarify expected behavior in our community. You can read it at CODE_OF_CONDUCT.

Get In Touch

Members of the F# Software Foundation are invited to the FSSF Slack. You can find support from other contributors in the #compiler and #editor-support channels.

Additionally, you can use the #fsharp tag on Twitter if you have general F# questions, including about this repository. Chances are you'll get multiple responses.

About F#

If you're curious about F# itself, check out these links:

• What is F#
• Get started with F#
• F# Software Foundation
• F# Testimonials