Recent

Author Topic: Tutorial page web/wiki  (Read 4936 times)

Handoko

  • Hero Member
  • *****
  • Posts: 3847
  • My goal: build my own game engine using Lazarus
Tutorial page web/wiki
« on: January 25, 2020, 08:18:18 pm »
~off topic~

@Martin_fr

May I suggest a section for short demos? I saw people often wrote demos for answering question in the forum. Some of them are short but interesting, should be shown to the public. I think they will be attractive for newbies.

For examples:

Move shape with mouse by mousemove by furious programming:
http://forum.lazarus.freepascal.org/index.php/topic,43376.msg303582.html#msg303582

Drawing, moving and make connection between shapes by Handoko:
http://forum.lazarus.freepascal.org/index.php/topic,41036.msg284131.html#msg284131

A simple pong game by Handoko:
http://forum.lazarus.freepascal.org/index.php/topic,42439.msg297949.html#msg297949

There are lots of them, but I forget where they are.

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 6674
  • Debugger - SynEdit - and more
    • wiki
Re: Tutorial page web/wiki
« Reply #1 on: January 25, 2020, 08:26:52 pm »
I haven't checked if we already have something or not.

But to start with, maybe a tutorial page overview on the wiki? Maybe even as a portal https://wiki.lazarus.freepascal.org/Category:Portals ?
Then create individual wiki pages for each of them, or link to the forum.

The page could be linked from the home page, in the "Education" section.

This is already linked on top of the home page https://wiki.freepascal.org/Lazarus_Documentation#Lazarus_and_Pascal_Tutorials
Could be somehow integrated and the link adjusted.....

Handoko

  • Hero Member
  • *****
  • Posts: 3847
  • My goal: build my own game engine using Lazarus
Re: Tutorial page web/wiki
« Reply #2 on: January 25, 2020, 08:31:08 pm »
I meant to put them on the Lazarus website. I think newbies / new comers are not likely to visit the wiki.

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 6674
  • Debugger - SynEdit - and more
    • wiki
Re: Tutorial page web/wiki
« Reply #3 on: January 25, 2020, 08:51:37 pm »
I meant to put them on the Lazarus website. I think newbies / new comers are not likely to visit the wiki.

It wouldn't be a problem to add a page, if someone creates and maintains it.
But the latter is kind of the issue => it needs maintenance. Even with a volunteer, there would then be only one person to integrate the updates. (And people would need a way to reach that person)

Currently we have the "online tutorials" link on the website. (It's in the top section, no scrolling needed). That should be easy to find.

The problem is => the wiki page to which it points needs a maintainer.
If it gets reworked, and made to look like the portal pages then new users would probably use it.

Look at https://wiki.lazarus.freepascal.org/Portal:Windows => that page invites to stay.


As for doing more on the website....

If someone does the work, we can add one new page "Help",  "First steps" or "Docs and info" or ......

But I do not think this page should actually hold the content (i.e. list of tutorials) => that changes. And people who want to add new tutorials should be able to do that and add them.

So what could be on the page is like a directory of help pages. Link to the online help and what to expect from the help, link to one or more wiki portals, and what to expect to find there.

I suggest various groups of links into the wiki (mainly to portal pages)
install/setup
first step creating and apps / tutorials
OS specifics
....

If we put all those links on one (sub-) page, rather than having them strewn all over the main page, that might indeed be helpful.

What do you think?



Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 6674
  • Debugger - SynEdit - and more
    • wiki
Re: Tutorial page web/wiki
« Reply #4 on: January 25, 2020, 08:56:31 pm »

trev

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 994
  • Former Delphi 1-7, 10.2 User
Re: Tutorial page web/wiki
« Reply #5 on: January 25, 2020, 10:47:34 pm »
But to start with, maybe a tutorial page overview on the wiki? Maybe even as a portal https://wiki.lazarus.freepascal.org/Category:Portals ?

Portals are fantastic concepts which thematically gather together all the scattered and otherwise difficult to find Wiki pages. Unfortunately the Portal pages suffer a similar fate of being scattered and difficult to find.

Can we please add the Portal page galleries which serbod prototyped at https://wiki.lazarus.freepascal.org/SANDBOX to the Main Page? At the moment none of these can be found from the home page.

If noone else takes it up in the near future, I'll also look at creating a Tutorials portal which is not a small undertaking - there are already a lot of tutorials in the Wiki, from programming AVR microcontrollers to adding an Apple Help book to an application. See: https://wiki.lazarus.freepascal.org/Category:Tutorials
o Lazarus v2.1.0 r63871, FPC v3.3.1 r46876, macOS 10.14.6 (with sup update), Xcode 11.3.1
o Lazarus v2.1.0 r61574, FPC v3.3.1 r42318, FreeBSD 12.1 amd64 (VMware Fusion VM)
o FPC 3.0.4, FreeBSD 12.2-STABLE r365646 amd64
o Lazarus v2.1.0 r61574, FPC v3.0.4, Ubuntu 18.04 (Parallels VM)

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 6674
  • Debugger - SynEdit - and more
    • wiki
Re: Tutorial page web/wiki
« Reply #6 on: January 25, 2020, 11:16:49 pm »
Regarding the image portal links for the main page:
I sent out a mail to the other team members. Just to make sure there is nothing about the main page that I am unaware of.

If there is not, I will take care of it in a bit.

GAN

  • Sr. Member
  • ****
  • Posts: 301
Re: Tutorial page web/wiki
« Reply #7 on: January 25, 2020, 11:17:12 pm »
A section with examples or "how to" would be interesting. I agree with @handoko, there are very good demos attached in the forum messages.
Lazarus 2.0.8 FPC 3.0.4 Linux Mint Mate 19.3
Zeos 7.2.6 - Sqlite 3.32.3

https://gitlab.com/users/GAN__/projects

vladimirr

  • New Member
  • *
  • Posts: 21
Re: Tutorial page web/wiki
« Reply #8 on: January 25, 2020, 11:41:10 pm »
Quote from: Handoko
May I suggest a section for short demos? I saw people often wrote demos for answering question in the forum. Some of them are short but interesting, should be shown to the public. I think they will be attractive for newbies.

Good idea! It will be useful to have a collection of good quality demo applications!

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 6674
  • Debugger - SynEdit - and more
    • wiki
Re: Tutorial page web/wiki
« Reply #9 on: January 25, 2020, 11:52:01 pm »
Just to mention, on top of the tutorial links in previous posts of this thread, we also have
https://wiki.lazarus.freepascal.org/Projects_using_Lazarus
https://wiki.lazarus.freepascal.org/Lazarus_Application_Gallery

vladimirr

  • New Member
  • *
  • Posts: 21
Re: Tutorial page web/wiki
« Reply #10 on: January 26, 2020, 12:01:00 am »
Quote from: Martin_fr
Just to mention, on top of the tutorial links in previous posts of this thread, we also have
https://wiki.lazarus.freepascal.org/Projects_using_Lazarus
https://wiki.lazarus.freepascal.org/Lazarus_Application_Gallery

By the way, how I can add my application to these lists?

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 6674
  • Debugger - SynEdit - and more
    • wiki
Re: Tutorial page web/wiki
« Reply #11 on: January 26, 2020, 12:07:38 am »
By the way, how I can add my application to these lists?
Top right of the wiki page: register.
Once registered you can edit (most) pages.

dbannon

  • Hero Member
  • *****
  • Posts: 1165
    • tomboy-ng, a rewrite of the classic Tomboy
Re: Tutorial page web/wiki
« Reply #12 on: January 26, 2020, 04:09:55 am »
Too right !  I really like the idea of a wiki page listing pointers to smaller tips and trick, demos etc in the forum. 

Maybe its a good idea if when someone adds the forum link to the wiki page, they also post a message to the forum thread saying "I just added this to XXX wiki page". That way, people, especially ones looking for those little demos, will be aware of the wiki page.

Davo
Lazarus 2, Linux (and reluctantly Win10, OSX)
My Project - https://github.com/tomboy-notes/tomboy-ng

dbannon

  • Hero Member
  • *****
  • Posts: 1165
    • tomboy-ng, a rewrite of the classic Tomboy
Re: Tutorial page web/wiki
« Reply #13 on: March 05, 2020, 08:45:56 am »
Right, while this is definitely Handoko's idea, just about every one agrees its a good one.  I'm going to give it a bump !

Handoko wanted it on the main website rather than the wiki. I suggest a link from the main website to a a wiki page is easiest solution. Below is my first cut at some usage guidelines.  I think this is what people have in mind. Unless someone objects, I will create a wiki page along these lines and we can do any necessary development there rather than a long conversation here on the forum.

Table of Contents
.........
.........

Guidelines
* This page contains a number of tips, tricks and techniques relating to coding FPC/Lazarus projects. Its a wiki page and that means everyone is entitled, indeed, encouraged, to contribute.

* If you see something relevant in the forum or elsewhere (always observing copyright and license) please add it to this page.
   
* Content that relates to one particular component is better added to that component's own wiki page.  If its more than just how to use the component, please link it under "Components".  Conversely, content that applies to multiple components belongs here with links from the relevant components.

* This page is about small snippets rather than large works, if what you need to add is longer than 20 or so lines, maybe its a new page page in its own right.

* Please add only things you know are correct, testing yourself is a great idea.

* Remember that this page is particularly targeted at new users but thats no reason to leave out advanced topics. 

* Please try and keep within the heading structure but don't be afraid to add a new heading if its necessary.

* Don't duplicate wiki content, a few well chosen words and a link may be all thats needed. And a link to a forum thread may well also be appropriate.

* When adding content, say from a FPC/Lazarus forum, post a note on that forum thread saying what you have done.

* There is a separate page for IDE Tips and Trick (link)


Drawing and Graphics



Database


Basic Programming


.......
 
Lazarus 2, Linux (and reluctantly Win10, OSX)
My Project - https://github.com/tomboy-notes/tomboy-ng

minesadorada

  • Hero Member
  • *****
  • Posts: 605
  • Retired
Re: Tutorial page web/wiki
« Reply #14 on: March 05, 2020, 01:09:00 pm »
Some good stuff in Category "Code Snippets".  I sometimes post forum snippets there.

https://wiki.lazarus.freepascal.org/Category:Code_Snippets
GPL Apps: Health MonitorRetro Ski Run
OnlinePackageManager Components: LazAutoUpdate, LongTimer, PoweredBy, ScrollText, PlaySound, CryptINI

 

TinyPortal © 2005-2018