Help Dosyası Hazırlama - 11. HPJ dosya yapısı

HPJ dosyasının bölümleri:

ALIAS

Bu bölüm isteğe bağlıdır. Zorunlu değildir.
Bir program bölümünün yardımını birden çok konu ile açıklamak gerekirse o konulara ait kelime grubu başka bir kelime grubuna eşitlenir.
Boşluk kullanmamaya dikkat edin.
Örnek:

[ALIAS]
software=yazilim
bilgisayar_yazilimi=yazilim
hardware=donanim

Eğer bu tanımlamalar ayrı bir dosyada ise;

[ALIAS]
#include<dosyaadi.h>

yazılarak kullanılır.

BAGGAGE

Bu bölüm de isteğe bağlıdır. Mültimedya dosyalarının(bitmap,ses,video...) listesi yazmak için kullanılır.
Kullanılacak dosyalar burada verilerek HLP dosyanın performansını arttırılır.

[BAGGAGE]
resim1.bmp
resim2.bmp
ses1.wav
video1.avi

BITMAPS

RTF dosyada bmc, bml, ve bmr komutları için resim dosya konumlarını ve adlarını belirtmek için kullanılır.
Eğer OPTIONS bölümünde BMROOT ile resimlerin klasörü belirtilmişse dosya yolunu yazmaya gerek yok, yalnız dosya adlarını yazmak yeterlidir.

[BITMAPS]
resim1.bmp
resim2.bmp
c:\RESIMLER\BUTON\buton3.bmp

BUILDTAGS

Bu bölüm de isteğe bağlıdır.
Koşullu derleme yapılacaksa ya da dosyanın yeni bir versiyonu yapılsın isteniyorsa kullanılır.

[BUILDTAGS]
DEMO
MASTER
DEBUGBUILD
TESTBUILD

CONFIG

Butonları ve yardım makrolarını yazmak için kullanılır.
Kursun önceki bölümlerindeki hpj dosyalarında kullanılmıştı.

[CONFIG]
BowseButtons()
About()
CreateButton("btn1", "&Buton1", "JumpContents('PROJE8.HLP')")

FILES

Derlenecek RTF dosyalar yolu ve adıyla yazılır.
Eğer ROOT kısmında klasör adı verilmişse ya da rtf dosyalar hpj dosya ile aynı klasördeyse yalnız dosya adını yazmak yeterlidir.

[FILES]
dosya1.rtf
dosya2.rtf
C:\HELP\dosya3.rtf
..\DOSYALAR\dosya3.rtf

Eğer dosyaların listesi başka bir dosyada yazılı ise;

[FILES]
#include <dosyalar.h> 

yazılarak kullanılır.

MAP

Bu bölüm de isteğe bağlıdır.
Help dosyalarının konu adlarına numaralar vermek için kullanılır.
Çalışan programda uygun kodlama ile bu numaralar ile ilgili konu sayfaları açılabilir.

[MAP]
Edit_Window 0x0001
Control_Menu 0x0002
Maximize_Icon 0x0003
Minimize_Icon 0x0004
Split_Bar 0x0005
Scroll_Bar 0x0006
Title_Bar 0x0007
Window_Border 0x0008 

OPTIONS

Bu bölüm dosyaların nasıl derleneceği ile ilgili bazı ayarları saklar.
Bu bölüme yazılacak komutlar:

BMROOT

bmc, bml, bmc komutları için kullanılacak resim dosyaların klasörünü belirtmek için kullanılır. Resimler ayrı klasörlerdeyse birden çok klasör adı yazılabilir.

[OPTIONS]
BMROOT=C:\HELP\BMP, D:\GRAPHICS\ART 

BUILD

BUILDTAG de belirtilen tagler ile derleme yapar.

BUILD = DEMO ; konuları DEMO tagiyle derle
BUILD = DEMO & MASTER ; konuları DEMO ve MASTER tagleriyle derler. 

COMPRESS

Derlenecek dosyaların hangi düzeyde sıkıştırılacağı belirtilir.

COMPRESS = 1
0 Sıkıştırma yok
1 Yüksek sıkıştırma
FALSE Sıkıştırma yok
HIGH Yüksek sıkıştırma
MEDIUM Orta sıkıştırma
NO Sıkıştırma yok
TRUE Yüksek sıkıştırma 
YES Yüksek sıkıştırma 

CONTENTS

Yardım dosyası açıldığında İçindekiler butonuna basıldığında gösterilecek sayfayı belirtmek için kullanılır. Belirtilmezse RTF dosyalar derlendiğinde, FILES de belirtilen ilk dosyanın ilk konusu olur.

CONTENTS=icindekiler

COPYRIGHT

Hakkında butonuna ya da menüden Yardım / Sürüm 'ü tıkladığımızda çıkan pencerede görünecek yayın hakkı bilgisini belirtmek için kullanılır. Zorunlu değildir.

COPYRIGHT = © 2001 Mesut Akcan

REPORT

Derleme sırasında mesajların ekranda görünmesini sağlar

REPORT = ON

ROOT

Dosyalar derlenirken gerekli olan dosyalar için bakılacak klasör adını vermek için kullanılır.

ROOT= C:\HELP, C:\RESIMLER

TITLE

Yardım pencere başlığında çıkacak yazıyı belirtmek için kullanılır. Belirtilmezse "Windows Yardım" yazar.

TITLE = Deneme help dosyasi

OPTINS bölümünün bunlardan başka birkaç alt komutu daha vardır. Onları Windows SDK dan inceleyiniz.

WINDOWS

Bu bölüm ana yardım penceresinin ve diğer pencerelerin özelliklerini belirtmede kullanılır.
type = "başlık", (x, y, genişlik, yükseklik), boyutlandırma, (arka plan rengi), (kaydırılamaz alan rengi), (ikinci pencere en üstte=1)

[WINDOWS]
main=, (, , , ), 0, (, , ), (128, 0, 128)
picture = "Samples", (123,123,256,256), 0, (0,255,255), (255,0,0)