Livro (e-book) Harbour

[Vlademiro]

Baixei o xDev 0.7 do Vailton, fiz uns testes e está dando tudo certo até agora.

[janio]

Vlademiro,

Acho que o tópico foi um pouco desvirtuado rsrsrsrs, ja que o e-book eh para iniciantes e não programação avançada!

Falei isso la atras oh:

Vlademiro, meu conterrâneo cearense hehehe

Uma sugestão: acredito que também para o iniciante, que é pra quem se destina seu e-book, seria bom um capítulo sobre a montagem do ambiente para compilação (isso eh chato pra caramba hehe), com links para baixar o Harbour 3.2 (acredito que é o mais usado) e também o compilador MinGW, com os respectivos ajustes do path,

Janio

O iniciante que começa a ler seu e-book tem uma visao inicial da linguagem, mas logo em seguida tem alguns exemplos de fontes. Como ele vai compilar os exemplos e ver na prática como tudo funciona, se ele não tem ainda montado um ambiente de programação e compilação?

Minha sugestão eh logo de cara apresentar o harbour, indicando:

1 - Sugestão de algum editor com o respectivo link, esclarecendo, inclusive, que os fontes em harbour tem a extensão .prg, que eh para o iniciante salvar seus exemplos nesta extensão.
2 - Link para baixar a ultima versao estavel do harbour (3.2);
3 - Link para baixar o compilador padrão (MinGW);
4 - Ajustes de path no windows;
5 - exemplos de compilação (hbmk2 exemplo.prg... etc etc etc)

Janio

[Vlademiro]

Oi Jânio, obrigado pelas dicas.

Você tem razão, eu é que comecei a escrever "avechado" (como se diz aqui no Ceará) e acabei atropelando tudo.

Eu já havia notado essas falhas durante a semana e nas horas vagas fiz algumas alterações. Não postei no git pois estou com problemas para postar lá. Eu uso aqui em casa o XP com um programa tipo Deep Freeze (Shadow Box o nome dele). Aí fica excluindo as minhas configurações.

Bom, mas vamos as alterações :

1 ) Padrão de codificação ficou sendo a antiga mesmo (PT850). Eu pretendo disponibilizar alguns códigos parcialmente digitados e uma codificação padronizada ajuda com os acentos.

2 ) Estou preparando um zip com tudo : Harbour, Gcc e xDevStudio para facilitar a instalação. No livro já tem as instruções. O xDevStudio é muito bom e, pelos testes que fiz aqui ele é portable. Então é só descompactar a pasta com o Harbour e o xDevStudio e configurar o PATH que tudo vai funcionar. Detalhei tudo nos capítulos iniciais.

3 ) Retirei as notações novas que não foram ainda implementadas. (AS NUMERIC)

4 ) Inclui muitos detalhes e um capítulo extra sobre o processo de compilação.


Segue uma amostra totalmente revisada até o capítulo 4 (já escrevi até o capítulo 7, mas ta meio bagunçado ainda) estou preparando também uns apêndices ensinando a baixar o Harbour e instalar no Windows, Linux, etc. Também explicando codificação, e outros detalhes importantes que se ficassem no livro iriam mais atrapalhar do que ajudar.

Harbour.pdf

(421.33 KiB) Baixado 304 vezes

:xau

[JoséQuintas]

Acho que depois das postagens deu pra entender porque usar o default.

Se começar logo com codepage, já viu a complicação.

Aliás....
Convém tratar tudo como default.
Até mesmo datas, coisa que no Clipper não era igual no Harbour.

Código: Selecionar todos

x := Stod( "20160821" )

Isso funciona sempre, independente do formato de data dos fontes.
No Clipper não lembro de poder usar um formato universal.

E já convém alertar sobre codepage, como assunto posterior, em capítulo próprio, porque isso vai longe.

Se tratar logo de cara, vai espantar todos... rs

[Vlademiro]

Atualização da semana.

Harbour.pdf

(540.65 KiB) Baixado 334 vezes

[Vlademiro]

Quando eu publico eu vejo que tem alguma coisa errada.

Na página 39 eu seu a palavra "parênteses", quando na verdade era para usar "aspas".

Postei aqui para me lembrar de mudar mais tarde.

[Vlademiro]

Atualização.

Harbour.zip

(586.64 KiB) Baixado 454 vezes

Vou deixar de publicar por aqui para evitar sobrecarregar o fórum com arquivos que não estão finalizados. Vou regularizar a conta no github (lá ta dando problema) e ficar apenas avisando aqui quando atualizar.

[JoséQuintas]

Dá uma pesquisada no github como salvar o manual pronto sem controle de versão.
Com controle também dá certo, mas sem controle evita acumular backups desnecessários.
Só retira esse controle do arquivo "compilado" do manual, mantendo dos arquivos individuais.

Compare isso com fontes de um aplicativo e o EXE.
O controle dos fontes é importante, mas para o EXE basta o final que será usado pra download.
Ter todas as versões do EXE vai ser só gastar espaço à toa.

Não sei como fazer isso, mas sei que é possível.
Tem a ver com a configuração na pasta .GIT, que pode ser modificada via comandos.
Uma vez configurado, fica resolvido pra sempre.

A partir daí, seria só publicar o link aqui.

[mjuliao]

Vlademiro, excelente iniciativa parabéns!
Gostaria de sugerir que no proprio e-book (pdf) fosse indicado o link da fonte para que fosse verificado novas versões caso existam.
Abraço!

[Vlademiro]

Valeu pela dica, vou fazer isso. Desde a postagem inicial eu todos os dias acrescento alguma coisa ao livro, já tenho bastante código de exemplo, mas ainda falta muito. Acabei criando alguns capítulos adicionais (detalhando um pouco mais a interface texto), de modo que esse que vc deve ter baixado está bem defasado. Não vou postar ainda porque quero pelo menos concluir totalmente a versão inicial dele para depois receber as críticas. De lá para cá o Harbour mudou um pouco, os desenvolvedores criaram a declaração de variáveis nos moldes do Visual Objects e eu vou criar alguns apêndices. Mas não estou em um ritmo muito rápido por que tenho outros projetos, ligados ao Harbour ou não.

[asimoes]

Vlademiro,

Muito obrigado pela sua contribuição, posso fazer uma sugestão no PDF?
É possível você colocar marcadores?

Como no exemplo a seguir:

[Vlademiro]

É uma boa ideia colocar marcadores, pois facilita a pesquisa, principalmente se o PDF estiver em um tablet ou smartphone.
Provavelmente deve existir sim uma forma de colocar, eu é que não sei como fazer.

Vou pesquisar um pouco no google e ver alguma coisa sobre isso.

[sygecom]

Parabéns, ficou muito bom.

[Vlademiro]

É pessoal, realmente vou ficar devendo esses índice por dois motivos :

1 ) O comando Latex que faz esse índice não está funcionando com o template que eu uso. Esse meu template está desatualizado.

2 ) Eu não tenho conhecimentos suficientes em Latex para alterar isso.

Eu disse que não iria mais publicar até ficar apresentável, mas vou só mandar um capítulo de exemplo. Lá eu consegui o que o Alexandre sugeriu, e consegui Links clicáveis dentro do documento, mas aí a parte que faz a bibliografia e as referências das imagens parou de funcionar.

Essa versão é uma versão resumida e tem apenas um capítulo sobre interface caractere. Lá aparece capítulo 1, mas na verdade é o capítulo 8 do livro. Veja que tem o índice mas as referências sumiram.



Vou tentar mais um pouco, se não conseguir o índice (bookmark) será retirado pois as referências bibliográficas e as imagens são mais importantes.

[Vlademiro]

É... realmente não consegui incluir os links. Vou ficar devendo essa dos links.

Segue a última versão com tudo o que fiz até agora : http://www.4shared.com/office/SDh3wvPKc ... r__1_.html

acho que a versão final ficará com umas 500 páginas mais ou menos.