Article cover image

Dica rápida: Melhore seus blocos de código em blogs com uma tag de linguagem

Hoje aprendi algo muito útil sobre blocos de códigos no Hashnode (e possivelmente funciona em outras plataformas de blog também) que imediatamente decidi compartilhar com a comunidade.

Para explicar isso deixe-me primeiro mostrar o resultado sem uma tag de linguagem:

func calculateHourlyPay(for workingHours: Int, at dayOfWeek: String) -> Double {
    let paymentPerHour: Double = 30

    let normalHours: Double = workingHours > 8 ? 8 : Double(workingHours)
    let overtimeHours = workingHours > 8 ? Double(workingHours - 8) : 0

    var payment: Double = 0

    if dayOfWeek == "sun" {
        payment = normalHours * paymentPerHour * 2
        payment += overtimeHours * paymentPerHour * 2 * 1.5
    } else if dayOfWeek == "sat" {
        payment = normalHours * paymentPerHour * 1.2
        payment += overtimeHours * paymentPerHour * 1.2 * 1.5
    } else {
        payment = normalHours * paymentPerHour
        payment += overtimeHours * paymentPerHour * 1.5
    }

    return payment
}

Note como o código ficou mal interpretado, pouca distinção de cores. O bloco de código não entendeu que escrevi código em Swift. Deixe me ajuda-lo entender isso adicionando a tag de linguagem:

func calculateHourlyPay(for workingHours: Int, at dayOfWeek: String) -> Double {
    let paymentPerHour: Double = 30

    let normalHours: Double = workingHours > 8 ? 8 : Double(workingHours)
    let overtimeHours = workingHours > 8 ? Double(workingHours - 8) : 0

    var payment: Double = 0

    if dayOfWeek == "sun" {
        payment = normalHours * paymentPerHour * 2
        payment += overtimeHours * paymentPerHour * 2 * 1.5
    } else if dayOfWeek == "sat" {
        payment = normalHours * paymentPerHour * 1.2
        payment += overtimeHours * paymentPerHour * 1.2 * 1.5
    } else {
        payment = normalHours * paymentPerHour
        payment += overtimeHours * paymentPerHour * 1.5
    }

    return payment
}

Opa, muito melhor!

Como eu fiz isso? Primeiro veja como foi escrito o primeiro bloco de código sem a tag de linguagem: without language tag.jpg

Agora veja a versão atualizada com a tag de linguagem:: with language tag.jpg

Bem simples né?

Conclusão

Blocos de código são muito úteis para escrever artigos técnicos com códigos de exemplos. Porém algumas vezes ele não entende em qual linguagem o código foi escrito e é melhor indicar isso explicitamente para facilitar a compreensão. Para isso adicione sempre a tag da linguagem que estiver usando!