Markdown

const Mel — Sat, 30 Sep 2023 20:47:32 +0000

Apesar de ser algo relativamente simples, o markdown ainda é um mistério para muitas pessoas, fazendo com que tenham dificuldades em criar um READ ME tanto para projetos quanto para o próprio perfil no GitHub. Estarei criando este tutorial básico para falar algumas das coisas que é possível fazer com o markdown.

Começando pelos títulos! Podemos usar tanto # para indicar a importância dos títulos quanto as próprias tags de h1(...). Assim como a tag, quanto mais # você adiciona no seu título, menor vai ser a importância dele.

Exemplo de título com '#'

Exemplo de títulos com '##'

Já para os parágrafos a lógica é a mesma, podemos apenas escrever sem nenhuma tag no nosso arquivo READ ME ou para quem preferir, podemos utilizar a tag p.

Ainda falando dos parágrafos, temos alguns símbolos que mudam o estilo da fonte para itálico ou negrito. É possível __ __ para negrito e _ _ para itálico.

Exemplo de __texto__ em negrito e _texto_ em itálico.

E sobre as imagens? Também temos duas formas de inserir imagens nos nossos arquivos. O primeiro método é utilizar ![]() e o segundo, de forma óbiva, a tag img. Vamos por partes, dentro das chaves [] Você coloca o título que gostaria de dar para sua imagem e dentro dos parênteses () você cola o endereço da imagem que você deseja, ficando mais ou menos assim: ![imagem de exemplo](link da imagem).

Também podemos falar das listas e tabelas. Para fazer uma lista é simples, só é necessário colocar * em forma de coluna, já para a tabela, precisamos montar sua estrutura de forma manual.

Exemplos:

Lista de compras: 
* Morango
* Banana
* Leite


Nome   | Idade | Sexo
-------|-------|-----
Melyssa| 19    | F

Caso você queira mudar a centralização da sua tabela, você deve usar o ! na direção que deseja: !---- para centralizar para a esquerda ----! para a direita e !----! para o meio.

E se eu quiser escrever um bloco de código? Também é possível, utilizando ou apenas uma crase ou crase tripla.

Qual o sentido de utilizar tags?

Quando utilizamos as tags temos acesso a algumas propriedades que o markdown puro não nos fornece, como por exemplo, quando utilizamos a tag img podemos definir o width e o height da imagem de forma manual com css inline.

Também é possível usar align="center" em divs, tags a e etc. O markdown é cheio de coisas que podemos aproveitar para deixar todo o nosso projeto mais bonito! Espero que tenham gostado e até a próxima <3

Bônus - Repositórios para utilizar no markdown

https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md
https://github.com/antonkomarev/github-profile-views-counter
https://docs.pipz.com/central-de-ajuda/learning-center/guia-basico-de-markdown#open

Python Orientado a Objetos 1

const Mel — Mon, 17 Jul 2023 23:17:21 +0000

Olá! Meu nome é Melyssa e este é meu primeiro artigo por aqui! Irei iniciar falando sobre Python Orientado a Objetos. Para ler o conteúdo abaixo é necessário já saber o básico dessa linguagem. Aceito sugestões e críticas construtivas, no futuro irei escrever sobre Python para quem irá ter o primeiro contato com a linguagem ❤️

Python Orientado a Objetos

Para trabalhar com Objetos em Python, primeiro precisamos criar uma classe que é onde vamos armazenar o bloco de código do nosso Objeto. Para criar uma classe é necessário usarmos o termo class e em seguida nomear nossa classe - seguindo o padrão CamelCase - seguido de dois pontos e depois a palavra pass que funciona como um return. Confira o código de exemplo abaixo:

class CodigoTeste:

    pass

Depois que a classe é feita, precisamos enfim criar o objeto para ela e para isso criamos uma variável que vai armazenar a class feita. Exemplo: teste = CodigoTeste() e assim temos nosso primeiro Objeto.

Podemos criar funções dentro da nossa class para armazenar e organizar melhor nossas informações, assim com funções já existentes no Python - que são chamados de métodos construtores, como por exemplo: init(self) que é uma função normalmente utilizada para o começo dos códigos. O parâmetro self é onde vai ficar a referência do nosso Objeto.

class CodigoTeste:
    def __init__(self, nome, idade, estado):
        self.nome = nome
        self.idade = idade
        self.estado = estado

Após feito isso apenas precisamos passar as informações dentro de nossa variável no terminal, como por exemplo: teste = CodigoTeste(’Melyssa’, 19, ‘São Paulo’) e pronto, criamos mais um Objeto!

Para acessar as informações que foram passadas dentro dos Objeto é extremamente simples, precisamos apenas chamar a variável que desejamos acessar e utilizar o ponto (.) junto do parâmetro que queremos acessar. Por exemplo: teste.nome vai retornar ‘Melyssa’.

Método privado

Caso tenhamos algum método dentro da nossa class que gostaríamos de informar e tornar privado, precisamos usar __ antes de seu nome. Assim o Dev que ver nosso código vai entender que aquele método é privado e que deve não deve ser utilizado diretamente e sim por outro método. O ideal no caso de querer modificar ou acessar uma informação privada, é criando um método get (no caso de pegar a informação) e set (no caso de modificar a informação), como por exemplo:

class CodigoTeste:
    def __init__(self, nome, idade, estado):
        self.__nome = nome
        self.__idade = idade
        self.__estado = estado

    def get_nome(self):
        return self.__nome

    def set_idade(self, idade):
        self.__idade = idade

teste = CodigoTeste('Melyssa', 19, 'SP')
teste.get_nome()
'Melyssa'
teste.set_idade(20)

Propriedades

Também podemos usar propriedades para fazer com que “métodos” se transformem em um Objeto. Utilizamos essas propriedades em classes privadas, acessando-a e modificando algo. Como por exemplo, podemos criar uma propriedade que sempre deixe a primeira letra do nome de uma pessoa em caixa alta, evitando erros de sintaxe, para isso usamos o @property logo acima. Exemplo:

class Nome:

    def __init__(self):
        self.__nome = nome

    @property
    def nome(self):
        return self.__nome.title()

teste = Nome('melyssa')
teste.nome
'Melyssa'

Lembrando que o nome da nossa propriedade precisa ser o mesmo nome do Objeto que desejamos alterar.

Caso queira mudar o valor do nome, também podemos utilizar uma propriedade setter, onde utilizamos a seguinte sintaxe: @(nome do atributo).setter. Assim podemos modificar os valores do nosso método desejado. Veja o código de exemplo abaixo:

@nome.setter
def nome(self, nome):
    self.__nome = nome

teste = Nome('Melyssa')
teste.nome = 'daniel'
teste.nome
'Daniel'

Métodos da Class (static methods)

Caso queiremos programar um método onde todos os Objetos compartilham a mesma informação em comum, podemos usar os métodos estáticos. Por exemplo, uma conta do Banco do Brasil sempre vai ter o código da conta como ‘001’, então podemos criar um objeto estático para ele. Para isso utilizamos o @staticmethod logo acima da nossa função desejada. Veja o código abaixo:

@staticmethod
def codigo__BB():
    return '001'

Como você pode notar, esse método não possui o parâmetro self, que é o responsável por armazenar a referência do Objeto.

Aqui acaba a primeira parte de Python Orientado a Objetos e logo publicarei a parte 2. Espero que tenham gostado, obrigada por terem lido até aqui! =)

DEV Community: const Mel