Author Topic: PixInsight 1.6.5 - Integration of the Reference Documentation System  (Read 16436 times)

Offline Juan Conejero

  • PTeam Member
  • PixInsight Jedi Grand Master
  • ********
  • Posts: 7111
    • http://pixinsight.com/
Hi all,

The next version of PixInsight has the new reference documentation system fully integrated in the PixInsight Core application. The Process Explorer window includes now a special web browser that loads existing tool and script documents automatically. For example, the screenshot below shows the documentation for the CurvesTransformation tool.


Each time you select a tool on the left column of Process Explorer, the new Documentation Browser loads the corresponding reference document automatically. The Documentation Browser is a custom integration of the WebKit engine, so it is basically a full featured web browser. You can navigate local documents and network resources as the following screenshot demonstrates.


The Documentation Browser includes a fully functional JavaScript engine, so the reference documentation can include interactive contents such as mouseover comparisons, animations, etc. Naturally, you can use PixInsight Forum from the Documentation Browser.


Finally, the Script Editor fully supports PIDoc documents with specialized syntax highlighting, as you can see in the next screenshot.


PixInsight 1.6.5 will include more important new features, which I'll be describing during the next days, and a lot of improvements and bug fixes in the standard tools and the core application. Stay tuned.
« Last Edit: 2010 October 22 11:50:31 by Juan Conejero »
Juan Conejero
PixInsight Development Team
http://pixinsight.com/

Offline Nocturnal

  • PixInsight Jedi Council Member
  • *******
  • Posts: 2727
    • http://www.carpephoton.com
Hi,

I have some reservations about this system but I'll wait to try it out before commenting. Needless to say I look forward to reading the docs.
Best,

    Sander
---
Edge HD 1100
QHY-8 for imaging, IMG0H mono for guiding, video cameras for occulations
ASI224, QHY5L-IIc
HyperStar3
WO-M110ED+FR-III/TRF-2008
Takahashi EM-400
PIxInsight, DeepSkyStacker, PHD, Nebulosity

Offline Harry page

  • PTeam Member
  • PixInsight Jedi Knight
  • *****
  • Posts: 1458
    • http://www.harrysastroshed.com


I'm tuned and waiting


Harry
Harry Page

Offline Emanuele

  • PixInsight Addict
  • ***
  • Posts: 270
WOOWOOOO!! Bring it on!!  8)

Offline Jordi Gallego

  • PixInsight Addict
  • ***
  • Posts: 279
Great news Juan! ;)
Jordi Gallego
www.astrophoto.es

Offline bitli

  • PTeam Member
  • PixInsight Guru
  • ****
  • Posts: 513
This is great, at least if the content is there too  ;)
bitli

Offline mmirot

  • PixInsight Padawan
  • ****
  • Posts: 881
Any more updates on 1.6.5?

Max

Offline h0ughy

  • PixInsight Addict
  • ***
  • Posts: 226
Any more updates on 1.6.5?

Max
any more on this^^^^^ ;)
Doghouse Observatory

Offline Carlos Milovic

  • PTeam Member
  • PixInsight Jedi Master
  • ******
  • Posts: 2172
  • Join the dark side... we have cookies
    • http://www.astrophoto.cl
Juan is working exclusively on the new updates system these days. This is a huge change, and things are quite critical, so he stopped documentation production for a while.
Regards,

Carlos Milovic F.
--------------------------------
PixInsight Project Developer
http://www.pixinsight.com

Offline DB

  • Newcomer
  • Posts: 15
Hello

Is the reference documentation enabled as a feature on 1.6.9 now?

regards

DB

Offline RBA

  • PixInsight Guru
  • ****
  • Posts: 511
    • DeepSkyColors
Re: PixInsight 1.6.5 - Integration of the Reference Documentation System
« Reply #10 on: 2010 December 20 20:09:55 »
Is the reference documentation enabled as a feature on 1.6.9 now?

I don't see docs for any process, not even the ones supposedly already available, but who's to tell I'm not doing something wrong.

Regardless, IMHO, rather than just having the documentation appearing automatically from the process explorer (or manually once you "open" the browser window that goes with it), I think it'd be a good idea to also have one new small icon in the process dialogs that'd bring out the docs for that process. Kind of like a "Help" button.  I bet many people don't use the process explorer and use instead the Process menu anyway. Sorry if the "help button" concept sounds boring, but usability-wise IT WORKS - plus I think "on demand" documentation right off the process window makes a lot of sense.

My 0.02€  ;)


Offline William McLaughlin

  • Member
  • *
  • Posts: 58
    • Images from the Night Sky
Re: PixInsight 1.6.5 - Integration of the Reference Documentation System
« Reply #11 on: 2010 December 20 20:12:42 »
I see the feature but I am getting "Tool documentation not available" for all the tools, even those like curves and histogram that I know there is content already done for.

What gives?

 
Quote
......think it'd be a good idea to also have one new small icon in the process dialogs that'd bring out the docs for that process. Kind of like a "Help" button.

I agree. The present way could remain but a separate window would also be nice, even if all it did was to open one's default internet browser and go to the appropriate content.
Website: http://nightskypictures.com/

Observatory: http://nightskypictures.com/raptor-ridge.html

For every complex problem there is an answer
that is clear, simple, and wrong.

H. L. Mencken

Offline RBA

  • PixInsight Guru
  • ****
  • Posts: 511
    • DeepSkyColors
Re: PixInsight 1.6.5 - Integration of the Reference Documentation System
« Reply #12 on: 2010 December 20 20:17:08 »
I don't see docs for any process, not even the ones supposedly already available, but who's to tell I'm not doing something wrong.

Well, there you go... You need to use the new update system, download the only update available (docs!), restart PixInsight, and docs for a handful of processes suddenly become available: HistogramTransformation, CurvesTransformation, etc.

In my case I had to bring out the browser window (the doubled-arrow icon at the bottom-right of the Process Explorer window). Docs didn't just pop unless I did that manually, which I think it's a good thing, though I still favor the "help button" thingy on each process window...



Offline William McLaughlin

  • Member
  • *
  • Posts: 58
    • Images from the Night Sky
Re: PixInsight 1.6.5 - Integration of the Reference Documentation System
« Reply #13 on: 2010 December 21 08:03:29 »
Well, there you go... You need to use the new update system, download the only update available (docs!), restart PixInsight, and docs for a handful of processes suddenly become available: HistogramTransformation, CurvesTransformation, etc.

In my case I had to bring out the browser window (the doubled-arrow icon at the bottom-right of the Process Explorer window). Docs didn't just pop unless I did that manually, which I think it's a good thing, though I still favor the "help button" thingy on each process window...

OK, I see now and it works. Still not too many of the processes that have actual content, however.

Any idea when the content will be more or less complete? Having done tutorials for other purposes I know that is tedious, but it is probably as important or more so than new features.
Website: http://nightskypictures.com/

Observatory: http://nightskypictures.com/raptor-ridge.html

For every complex problem there is an answer
that is clear, simple, and wrong.

H. L. Mencken

Offline bendun

  • Newcomer
  • Posts: 1
Re: PixInsight 1.6.5 - Integration of the Reference Documentation System
« Reply #14 on: 2010 December 21 10:50:23 »
I just installed the new update (01.06.09.0644- 64 bit version) but I don't see the automatic "Documentation Browser". I also don't see any way to manually obtain documentation. What am I doing wrong?

  Gary Bennett