quando - Online na nuvem

PROGRAMA:

NOME

Quando - um programa de calendário pessoal minimalista

SINOPSE

quando

quando [opções] [comandos]

A idéia básica é apenas digitar 'quando' na linha de comando. A primeira vez que você executa o
programa, ele solicitará algumas informações de configuração. Para editar seu arquivo de calendário em seu
editor favorito, faça `quando e '. O formato básico do arquivo de calendário é assim:

2003, 3 de fevereiro, Voo para Estocolmo para receber o Prêmio Nobel.

Assim que tiver um arquivo de calendário, execute o programa como o antigo `quando 'a partir do comando
line imprimirá os itens do seu calendário nas próximas duas semanas.

COMANDOS

i Imprima os próximos itens em seu calendário. (Este é o comando padrão.)

c Imprimir calendários (grades como em um calendário de parede, não mostrando itens) para o mês passado,
este mês e no próximo mês.

e Invoque seu editor favorito para editar seu arquivo de calendário.

w,m,y Imprimir itens para a próxima semana, mês ou ano, em vez do padrão
período de duas semanas.

j Imprime o dia juliano modificado (útil para encontrar o intervalo de tempo entre dois
datas).

d Imprima nada além da data atual.

OPÇÕES

Todas as opções a seguir, exceto --help, podem ser definidas no arquivo de preferências.
As opções verdadeiro / falso podem ser definidas na linha de comando como --option ou --nooption, e no
arquivo de preferências configurando a opção para 0 ou 1.

--help Imprime uma breve mensagem de ajuda.

--versão
Imprime uma breve mensagem, incluindo uma declaração de qual versão do software é
é.

--language = LANG
Defina o idioma como LANG. Veja a seção abaixo sobre internacionalização. Esse
normalmente não é necessária, porque o idioma é detectado automaticamente.

--future = DAYS
Quantos dias no futuro o relatório se estende. Padrão: 14

--past = DAYS
Quantos dias no passado o relatório se estende. Como a opção --future, --past
é interpretado como um deslocamento em relação à data atual, então normalmente você
deseja que seja um valor negativo. Padrão: -1

--calendar = FILE
Seu arquivo de calendário. O padrãoé usar o arquivo apontado por suas preferências
, que é configurado na primeira vez que você executa Quando.

--editor = COMANDO
Comando usado para invocar seu editor. Padrão: "emacs -nw" Exemplo: quando
--editor = "vim"

--wrap = COLUNAS
Número de colunas de texto para a saída (ou 0 se você não quiser quebra automática).
Padrão: 80

- [não] wrap_auto
Tenta detectar a largura do terminal e definir a largura da saída
adequadamente. Isso se aplica apenas se a saída for um tty e está sujeito a qualquer
máximo definido por --wrap_max. Substitui qualquer valor definido por --wrap. Padrão: não

--wrap_max = COLUMNS
Número máximo de colunas de texto para a saída (ou -1 se você não quiser
máximo). Útil em combinação com --wrap_auto para preservar a legibilidade em muito
grandes janelas de terminal. Padrão: -1

--rows = COLUMNS
Número de linhas de texto que cabem na janela do terminal. Ao listar o seu
calendário, a saída será truncada para este comprimento, a menos que isso resulte em
listando menos de três dias no futuro. Este comportamento é sobrescrito (o
o número máximo de linhas é definido como infinito) se a opção --future for fornecida
explicitamente, ou se o comando m ou y for usado. Padrão: 40

- [no] rows_auto
Tente detectar a altura do terminal, em vez de usar o valor definido em
a opção --rows. Isso se aplica apenas se a saída for um tty. Substitui qualquer valor
definido por --rows. Padrão: sim

--[nenhum cabeçalho
Imprima cabeçalhos na parte superior da saída dos comandos i, c, w, m e y. Predefinição:
sim

- [sem] paginação
Quando a saída for maior do que o valor definido por rows ou rows_auto, use um pager para
exibir a saída. (As variáveis ​​de ambiente PAGER e LESS são respeitadas.
PAGER não está definido, o padrão é "menos.") Padrão: sim

--paging_less_options
Opções extras se o pager for "menos". Padrão: "-rXFE"

- [no] filter_accents_on_output
Se deve alterar caracteres acentuados para não acentuados. Padrão: sim, a menos
a variável de ambiente $ TERM é igual a "mlterm" ou "xterm".

- [não] styled_output
Se a saída for um terminal, devemos usar códigos de terminal ANSI para definir o estilo?
Padrão: sim

- [no] styled_output_if_not_tty
Defina o estilo da saída, mesmo que não seja um terminal. Padrão: não

--calendar_today_style = ESTILO
--items_today_style = ESTILO
O primeiro deles diz como estilizar a data de hoje ao fazer o calendário (c)
comando. O segundo diz como estilizar a palavra `` hoje '' ao fazer os itens (i)
comando. Padrões: negrito

O estilo de saída pode ser especificado usando as seguintes palavras-chave: negrito,
sublinhado, piscando. Para alterar a cor do texto, use estes: fgblack, fgred,
fggreen, fgyellow, fgblue, fgpurple, fgcyan, fgwhite. Para mudar o fundo
color, use palavras-chave semelhantes, mas com bg em vez de fg. Exemplo: quando
--calendar_today_style = "negrito, fgred, bgcyan" c

--pré-filtro
Passe o arquivo de calendário por um programa antes de lê-lo. Predefinição: ""

--now = "YMD"
Finja que hoje é outra data.

- [no] neighbouring_months
O comportamento padrão de "quando c" é imprimir calendários do mês passado, este
mês e no próximo mês. Ao escolher --noneighboring_months, você pode evitar a impressão
meses não incluídos no intervalo definido por --past e --future.

- [não] segunda-feira_primeira
Comece a semana na segunda-feira, em vez de no domingo. Padrão: não

- [não] orthodox_easter
Calcule a Páscoa de acordo com o calendário da Igreja Ortodoxa Oriental. Padrão: não

- [não] ampm
Exiba a hora do dia usando o formato de 12 horas, em vez de 24 horas. Também afeta
a análise dos tempos de entrada. Padrão: sim

--auto_pm = x
Quando os horários são inseridos com horas inferiores a x, e AM ou PM não é
especificado explicitamente, assume automaticamente que são PM em vez de AM.
Padrão: 0

- [não] literal_only
Exibir apenas itens fornecidos como datas literais, por exemplo, "2008 de julho de 4". Não
exibir itens que são definidos por expressões, por exemplo, itens periódicos como "w = qui".
Padrão: não

--expressão_teste
--bare_versão
--make_filter_regex
--test_accent_filtering
Essas opções são usadas internamente para construção e teste.

DESCRIÇÃO

Quando é um programa de calendário pessoal extremamente simples, voltado para o geek do Unix que deseja
algo minimalista. Ele pode controlar o que você precisa fazer em datas específicas.
Existem muitos programas de calendário e "gerenciadores de informações pessoais" por aí, então
que razões existem para usar Quando?

É um programa muito curto e simples, então você pode facilmente modificá-lo sozinho.
Não depende de nenhuma biblioteca, por isso é fácil de instalar. Você deve ser capaz de instalar
em qualquer sistema onde Perl esteja disponível, mesmo se você não tiver privilégios para instalar
bibliotecas.
Seu formato de arquivo é um arquivo de texto simples, que você pode editar em seu editor favorito.

Apesar Quando deve ser executado em praticamente qualquer sistema operacional onde Perl está disponível, em
neste documento, presumo que você esteja executando algum tipo de Unix.

INSTALAÇÃO E OBTENDO COMEÇADO

Enquanto estiver conectado como root, execute o seguinte comando:

make install

Execute Quando pela primeira vez usando este comando:

quando

Você será solicitado a fornecer algumas informações necessárias para configurar seu arquivo de calendário.

USO

Se você correr Quando novamente após a execução da configuração inicial, ele deve imprimir uma única linha de
texto, informando a data atual. Não vai imprimir mais nada, porque o seu
o arquivo de calendário está vazio, então você não tem compromissos marcando.

Agora você pode começar a colocar itens em seu arquivo de calendário. Cada item é uma linha de texto que
se parece com isso:

2003, 3 de fevereiro, Voo para Estocolmo para receber o Prêmio Nobel.

Uma maneira conveniente de editar seu arquivo de agenda é com este comando:

quando e

Isso o leva ao seu editor favorito (aquele que você escolheu quando executou Quando pela primeira vez
tempo).

A data deve estar no formato ano-mês-dia, mas você pode soletrar o mês ou fornecer
como um número. (Os nomes dos meses não diferenciam maiúsculas de minúsculas e não importa se você representa
Fevereiro como F, Fe, Feb, Februa ou o que for. Só tem que ser uma combinação única. Você pode
dê um final., que será ignorado. Em tcheco, "cer" pode ser usado como abreviatura
para Cerven, e "cec" para Cervenec.) Espaços em branco extras são ignorados até que você entre no
texto real após a vírgula. Linhas em branco e linhas que começam com um sinal # são ignoradas.

Se você agora corre Quando, ele imprimirá uma lista de todos os itens em seu arquivo de calendário que
cair dentro de um determinado intervalo de tempo. (O intervalo começa ontem. Quando tenta
escolha o final do intervalo de tempo para que sua saída caiba na janela do seu terminal, mas
será sempre pelo menos três dias e não mais do que duas semanas no futuro.) Para ver todos
seus itens para o próximo mês, faça `` quando m '', e da mesma forma por um ano, y, ou um único
semana, w.

Se você fizer `` quando c '', Quando imprime calendários do mês passado, deste mês e do próximo
mês.

Você pode combinar esses comandos. Por exemplo, `` when cw '' irá imprimir calendários, e
em seguida, mostre seus itens para a próxima semana.

Para eventos que ocorrem uma vez por ano, como aniversários e datas comemorativas, você pode usar
a * no lugar do ano,

* 25 de dezembro, Natal

ou use um ano com um asterisco:

1920 * 29 de agosto, Charlie Parker faz \ a, nascido em \ y

No segundo exemplo, \ a informa quantos anos Charlie Parker teria este ano, e \ y
reproduz o ano em que nasceu, ou seja, a saída seria:

hoje, 2003 de agosto de 29, Charlie Parker completa 83 anos, nascido em 1920

Para coisas que você tem que fazer todas as semanas, você pode usar uma expressão da forma w = xxx, onde
xxx são as primeiras letras do nome do dia da semana no seu idioma. (Vocês
tem que fornecer letras suficientes para eliminar a ambigüidade, por exemplo, em inglês, w = th ou w = tu, não
apenas w = t.) Exemplo:

w = sol, ir para a igreja, 10:00

Você também pode fazer testes mais sofisticados; para mais informações, veja a seção
'testes sofisticados' abaixo. Veja como configurar alguns feriados comuns:

m = jan & w = mon & a = 3, dia de Martin Luther King
* 14 de fevereiro, Dia dos Namorados
m = fev & w = seg & a = 3, aniversário de Washington observado
m = may & w = sun & a = 2, Dia das Mães
m = may & w = mon & b = 1, Memorial Day
m = jun & w = sun & a = 3, Dia dos Pais
* 4 de julho, Dia da Independência
m = sep & w = mon & a = 1, Dia do Trabalho
m = out & w = seg & a = 2, Dia de Colombo
m = out & w = mon & a = 2, Thanksgiving (Canadá)
* 11 de novembro, Dia do Armistício
m = nov & w = qui & a = 4, Dia de Ação de Graças (EUA)
e = 47, Mardi Gras
e = 46, quarta-feira de cinzas
e = 7, Domingo de Ramos
e = 0, Domingo de Páscoa
e = 0-49, Pentecostes (49 dias após a Páscoa)

Nos EUA, quando certos feriados caem em um fim de semana, os funcionários federais, assim como muitos
funcionários privados, tenham uma folga na segunda ou sexta-feira. A lista completa é fornecida em
http://www.opm.gov/operating_status_schedules/fedhol/2011.asp. Se você quiser um lembrete de
tanto o feriado quanto o dia em que você sai do trabalho, aqui está um exemplo de como você definiria
isso até:

* 4 de julho, Dia da Independência
m = jul & c = 4, Dia da Independência (observado como feriado federal)

INTERNACIONALIZAÇÃO

Quando tem suporte pelo menos parcial para tcheco, dinamarquês, holandês, inglês, francês, alemão,
Grego, húngaro, italiano, polonês, romeno, espanhol e ucraniano. Se Quando não foi
traduzido para o seu idioma, ou foi apenas parcialmente traduzido, o texto que não foi
sido traduzido será exibido em inglês. Quando deve detectar automaticamente o que
idioma que você usa (por meio de sua variável de ambiente $ LANG), e se Quando foi traduzido
nessa linguagem, é isso que você obterá - Quandoa saída de será em seu idioma, e
Quando também espera que você use esse idioma em seu arquivo de calendário para os nomes dos
meses e dias da semana.

Seu arquivo de calendário deve estar em UTF-8 (ou ASCII, que é um subconjunto de UTF-8). Se seu
arquivo de calendário está em alguma outra codificação, como ISO-8859, Quando normalmente será capaz de
detectar isso, e se recusará a lê-lo. As opções de linha de comando também podem conter UTF-8.

Alguns emuladores de terminal (aterm, ...) exibem caracteres acentuados como lixo, mas outros
(mlterm, xterm ...) pode exibi-los corretamente. Quando verifica o ambiente $ TERM
variável, e se for igual a "mlterm" ou "xterm", então os caracteres acentuados serão
exibido. Caso contrário, eles são filtrados para fora da saída. Você pode substituir isso por
colocando uma linha como

filter_accents_on_output = 0

or

filter_accents_on_output = 1

na sua ~ / .quando / preferências Arquivo. Estou interessado em ouvir de todos os usuários que podem
sugerir um mecanismo melhor para isso do que tentar interpretar a variável $ TERM.

Na entrada, acentos são permitidos, mas não obrigatórios, por exemplo, em um arquivo de entrada em francês,
a data 2005 Fev 17 pode ser fornecida com um e acentuado ou não acentuado, e também
vai funcionar. Se um mês ou dia da semana inserido não corresponder a nenhum dos de seu
linguagem então Quando tentará interpretá-lo como inglês.

Você pode colocar uma linha como

idioma = fr

em seu arquivo de preferências para definir seu idioma, ou fornecer a opção --language no
linha de comando, mas isso não é necessário se sua variável de ambiente $ LANG estiver definida
corretamente.

FORMATO OF A PREFERÊNCIAS ARQUIVO

Cada linha consiste em algo assim:

variável = valor

O espaço em branco é ignorado em todos os lugares, exceto dentro do valor. Nomes de variáveis ​​são maiúsculas e minúsculas
insensível. As linhas em branco são ignoradas.

MAIS EXEMPLOS

Um comando útil para executar o shell ao fazer login é este:

quando --past = 0 --future = 1

Para imprimir um calendário para um ano inteiro:

quando --past = 0 --future = 365 c

ESTOQUE UP SUA CALENDÁRIO QUANDO VOCÊ LOG IN

Seu calendário não adianta nada se você se esquece de consultá-lo todos os dias. Um jeito facil
fazer com que apareça quando você faz login é fazer com que seu arquivo .xsession ou .xinitrc pareça
esta:

/ usr / bin / quando --past = 0 --future = 1 &>~ / quando hoje
emacs -geometria 70x25 -bg bisque ~ / quando hoje &
startkde

O arquivo .xsession é usado se você tiver um gerenciador de login gráfico configurado em sua máquina,
o .xinitrc se não o fizer. Neste exemplo, a primeira linha envia sua agenda para um
Arquivo. O caminho completo para o Quando programa é fornecido, porque a variável de caminho do seu shell
ainda não será inicializado corretamente quando for executado. A segunda linha exibe uma GUI emacs
janela, que tem uma cor diferente para chamar sua atenção. A última linha
inicia seu gerenciador de janelas, KDE neste exemplo. Qualquer gerenciador de janela que você usa, apenas
certifique-se de manter a linha preexistente no arquivo que o inicia, e certifique-se de que
essa linha é a última no arquivo.

ORDENAÇÃO BY TIME OF DIA

Se você quiser que os vários itens que ficam em um único dia sejam impressos em um determinado
ordem, a maneira mais simples de fazer isso é colocá-los nessa ordem no arquivo de entrada. Este
método não funcionará, no entanto, quando alguns dos itens estão em datas que são determinadas por
expressões em vez de fornecidas explicitamente. O motivo mais comum para querer fazer isso
tipo de coisa é que você tem coisas que precisa fazer em determinados momentos do dia, e
você quer que eles sejam classificados por tempo. Nesta situação, você pode dar um tempo no início
do texto do item, e Quando reconhecerá isso e classificará os itens por tempo. Os tempos podem ser
no formato h: mm ou hh: mm. Se --ampm for definido, um sufixo opcional a ou p pode ser usado para
AM ou PM, por exemplo, 9h30 para 9h30. Se você usar o horário AM / PM, também poderá, por exemplo, definir
--auto_pm = 9 de modo que as horas inferiores às 9 são automaticamente consideradas PM. Aqui está um
exemplo:

2010 de abril de 25, 7:00 jantar na comuna anarco-sindicalista
w = sol, 10:00 igreja

25 de abril de 2010 é um domingo, portanto, nessa data, ambos os itens serão exibidos. Se
--auto_pm é definido como 8 ou mais, então 7:00 será automaticamente interpretado como 7:00
PM e a data do jantar serão exibidos abaixo da cerimônia da igreja pela manhã.

CHIQUE TESTES

Além de w, discutido acima, há um monte de outras variáveis ​​que você pode testar:

w - dia da semana
m - mês
d - dia do mês
y - ano
j - número do dia juliano modificado
a - 1 nos primeiros 7 dias do mês, 2 nos próximos 7, etc.
b - 1 para os últimos 7 dias do mês, 2 para os 7 anteriores, etc.
c - na segunda ou sexta-feira, é igual ao dia do mês do final de semana mais próximo; caso contrário -1
e - dias até a Páscoa (ocidental) deste ano
z - dia do ano (1 no dia de ano novo)

Você pode especificar meses como números, m = 2, ou como nomes em seu idioma, m = fev. Vocês
também pode usar os operadores lógicos & (e) e | (ou). O exemplo a seguir lembra você
para pagar seus funcionários no primeiro e no décimo quinto dia de cada mês:

d = 1 | d = 15, pagar funcionários.

Este exemplo lembra você de ensaiar com sua banda no último sábado de cada mês:

w = sat & b = 1, Ensaie com banda.

As duas linhas seguintes

* 25 de dezembro, Natal
m = dez e d = 25, Natal

ambos fazem exatamente a mesma coisa, mas a primeira versão é mais fácil de entender e torna
o programa é executado mais rápido. (Quando você faz um teste, Quando tem que ser executado todos os dias no
intervalo de datas que você pediu e avalie o teste para cada um desses dias. Na minha maquina,
se eu imprimir um calendário para um ano inteiro, usando um arquivo com 10 testes simples nele,
leva alguns segundos.) Parênteses também podem ser usados.

Dependendo da sua nacionalidade e religião, você provavelmente tem vários feriados que
não minta em datas fixas. No Cristianismo, muitos destes (as "festas móveis") são
calculado em relação ao Domingo de Páscoa, razão pela qual a variável e é útil.

Não existe um operador,!:

w = sex &! (m = dez & d = 25), jogo de pôquer

Existe um operador de módulo,%, e um operador de subtração, -. Usando estes, junto com o
variável j, dificilmente é possível para Quandoo pequeno analisador para realizar o seguinte
Parceria:

! (j% 14-1), faça algo todas as quartas-feiras alternadas

A lógica por trás dessa pequena peça boba de magia é a seguinte. Primeiro, nós determinamos,
usando o comando `when j --now =" 2005 jan 26 "', que a primeira quarta-feira em que queremos
para fazer isso tem um dia juliano igual a 1, módulo 14. Então escrevemos esta expressão para
que se for uma quarta-feira cujo dia juliano é igual a 1, módulo 14, a quantidade entre parênteses
será zero, e tomar sua negação lógica produzirá um valor verdadeiro.

A associatividade e ordem de prioridade dos operadores (do mais alto para o mais baixo) é assim:

deixou %
esquerda -
esquerda <> <=> =
esquerda =! =
certo!
deixou &
esquerda |

INCLUINDO ARQUIVOS

Se o seu arquivo de calendário ficar muito grande, você pode preferir dividi-lo em pedaços menores -
talvez um para aniversários, um para feriados tibetanos, etc. Uma maneira fácil de realizar
isso é para instalar o programa m4, coloque a linha

pré-filtro = m4 -P

em seu arquivo de preferências e, em seguida, coloque linhas em seu arquivo de calendário como este:

m4_include (/home/yourname/.when/birthdays)

MEIO AMBIENTE

$ LANG para detectar automaticamente o idioma do usuário

$ TERM para tentar descobrir se o emulador de terminal pode exibir caracteres acentuados

Use quando estiver online usando serviços onworks.net